




FOREWORD 

One of the significant measures of the quality- of a computing system 
like the PDP-10 is the utility and availability of systems documenta- 
tion. Good manuals are the vital communications link between DEC 
and the people who use our systems. 

This collection has been organized for the convenience of PDP-10 
programmers, systems analysts, engineers and others who work at the 
machine language level. 

I’m pleased to acknowledge here the work of the mahy DEC system 
designers, engineers, and system programmers "who continue to ad- 
vance the state of the time-sharing art in both hardware and software. 
Also, to our PDP-10 users, who during the past two years, have helped 
immeasurably to improve and refine the system, and to the DEC soft- 
ware writers and technical artists who prepared this volume, our special 
thanks. 


President, Digital Equipment Corporation 
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PREFACE 

This volume is a comprehensive library of information for experi- 
enced prc^ramraers, systems analysts, and engineers who are interested 
in writing and operating assembly-language programs in the PDP-10 
time-sharing environment. 

The first three chapters deal with program preparation. Chapters 4 
and 5 are about loading, editing, testing, debugging, and running source 
language programs. Chapter 6 contains a miscellaneous collection of 
utility programs that have proven most useful to system designers and 
experienced programmers. 

As we expect to improve this book in future revisions, all readers are 
earnestly requested to send corrections and comments to: 

Manager, Software Writing Group 
Programming Department 
Digital Equipment Corporation 
Maynard; Mass. 01754 

A companion volume for beginning programmers and others who pre- 
fer to write programs in one of the popular compiler or conversational 
languages is scheduled for publication in 1970. 
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tasks. In batch processing, the PDP-10 can handle any 
stream of programs, such as a mixture of FORTRAN, 
MACRO- 10 and COBOL. Normally, batch processing 
operates without operator attention.However,thePDP-10 
allows the operator to stop or start the batch system, re- 
arrange the queue or call for a print-out to analyze pro- 
gram errors. The operator can also select and assign the 
desired input, output, and temporary storage devices to 
be used in batch processing. 

When real-time operations such as data acquisition and 
control are the primary purpose of the PDP-10, system 
software provides response in microseconds, processing 
information at speeds that meet the*most demanding re- 
quirements. High priority real-time tasks are interfaced 
directly to the priority interrupt system and control their 
own input/output operations for unlimited flexibility. 
Less critical real-time jobs are mdnitor controlled with 
a real-time clock assuring that each task does not exceed 
its allotted time and destroy the response of other pro- 
grams. For even greater efficiency, time not used by the 
real-time programs can be used for conversational time- 
sharing and/or batch processing. 


The PDP-10 is the successful culmination of many years 
of computer design research — a process which has 
enabled Digital Equipment Corporation to provide bet- 
ter computers at the lowest possible prices. 

Starting with the PDP-1 in 1959, DIGITAL has ^jo- 
neered the development of real-time systems for science 
and industry. Since then, each new system has increased 
in versatility, yet has consistently decreased the cost of 
computation. The PDP-1 was the first powerful real-time 
computer for under $150,000. The PDP-8 showed that 
an effective computer could sell for less than $20,000, 
and newer models in the PDP-8 family have lowered the 
cost to less than S 10,000. 

In developing its time-sharing capability, DIGITAL has 
built a history of success very similar to the company’s 
record in real-time applications. DIGITAL’S customers 
have been building time-sharing systems around PDP 
computers since 1960. And, in 1963, DIGITAL devel- 
oped its own time-sharing computer, PDP-6 — the first 
to be delivered with manufacturer-supplied hardware and 
software. . 

The PDP-10 reflects DIGITAL experience in both real- 
time and time-sharing. The system performs time-shar- 
ing and real-time operations equally well and simultane- 
ously and provides concurrent batch processing. 

In conversational time-sharing, up to 63 users at local 
and remote locations can simultaneously develop pro- 
grams on remote consoles and receive answers to mathe- 
matical or engineering problems in seconds. PDP-10 
time-sharing monitors provide instantaneous response 
for the users so that they can perform on-line composi- 
tion, editing, and debugging of programs in FORTRAN 
IV, MACRO- 10, COBOL, BASIC, and AID, with the 
use of EDITOR, TECO and DDT. The monitors can 
handle any mixture of these languages and programs 
concurrendy. And most of the software is re-entrant so 
that multiple users can share the same compiler.or utility 
program for increased efficiency. 


Structure of the PDP-10 

Every PDP- 10, uses one of three levels of monitors to 
allocate resources and perform input/output functions. 

The single-user monitor is used for dedicated systems 
which operate one program at a time. The multi-pro- 
gramming monitor controls the execution of multiple 
programs in core, switching between them at microsec- 
ond speeds. The swapping monitor effectively increases 
the available core by swapping programs between high ^ 
speed disk or drum storage and core memory. Thus 
more users can be served by a given amount of core. 

All language processors (FORTRAN, MACRO-10, 
COBOL, BASIC, and AID) operate identically under 
the multi-programming and swapping monitors. 

To make efficient use of memory, language processors; 
and important utility programs are re-entrant, that Is, 
the pure code for each program can be shared by mul- 
tiple users. Re-entrancy is possible since any program . 


For programs that don’t require immediate processing, 
users may initiate batch processing — a task which pro- 
ceeds concurrendy with time-sharing and real-time 


may be separated into a pure segment that never requires 
modification, and a segment which contains code or data 
which is relevant only to a particular user. For example, 
a re-entrant system can service three FORTRAN users 
with one 8 K compiler (pure code) and three 2 K user 
areas, a total dt 14 K, whereas a non-re-entrant system 
would require 30 K for the same programs. Since more 
users can occupy a given amount of. core space, system 
response improves and swapping time is reduced. Dual 
protection and relocation registers protect the active user 
and allow the program segments to reside in two non- 
contiguous sections of core memory. 


The PDP-10 memory bus structure gives the central 
processor and high speed data channels simultaneous 
access to separate memory modules. Only when the proc- 
essor and a data channel access the same module does 
the processor lose a memory cycle. Modules contain up 
to four ports, allowing access to a total of fpur processors 
and/or channels. Such parallel operation improves proc- 
essor utilization, yielding manyfold improvements over 
systems which provide only a single path to memory. The 
bus system allows each data channel to transmit full 36- 
bit words at speeds of up to one million words (5 mil- 
lion 7-bit characters) per second. 



Memory can be modularly expanded to 262,144 words 
of core, all of which (including the 16 accumulators 
and 15 index registers) can be directly addressed. Total 
memory capacity can be comprised of combinations of 
modules in 8,192-, 16,384-, 32,768-, 65,356-, and 
131,072-word blocks. Memory banks are asynchronous 
allowing interleaving and making it possible to intermix 
memories of different cycle times. 


The PDP-10 has a 36-bit word length allowing it to 
store 25 to 30 percent more information than a-32-bit 
system. The system stores five 7-bit USACII characters 
whereas the smaller word length computer stores only 
four characters. It also provides more accuracy in single 
precision floating arithmetic than computers with 32-bit 
word size. 


The PDP-10 has a large instruction repertoire to sim- 
plify assembly coding and reduce the size of higher level 
programs. Its 366 instructions divide logically into fami- 
lies and are easily learned. The list also includes an ex- 
tensive set of floating point and byte manipulation 
instructions. Due to instruction set efficiency, fewer in- 
structions are required to perform a given function. As- 
sembly language programs are therefore shorter than 
with other computers and the instruction set simplifies 
monitor systems, language processors, and utility pro- 
grams. For example, compiled programs are 30 to 50 per 
cent shorter, require less memory, and execute faster 
than those of comparable computers. 


To provide immediate service to real-time requests, the 
PDP-10 has a multi-level priority interrupt system. The 
system is a hardware feature, but is programmable for 
increased flexibility. Devices may be assigned to any level 
under program control and the entire interrupt system 
or any level may be selectively turned on or off. 


PDP-10 Configurations 

The modularity of PDP-10 hardware and software 
makes it economical to configure a wide variety of sys- 
tems and easy to expand the systems in the field. (See 
PDP-10 hardware list in Appendix A.) / An individual 
can buy a single user system and, at some later date, ex- 
pand to a small time-sharing system. Or the small time- 
sharing user can expand his system to serve 63 users 
simultaneously. Within any basic configuration, the user 
has a wide choice of memory sizes and speeds, input/out- 
put equipment, and storage facilities. For example, the 
input/output system alone can accommodate up to 128 
discrete devices and device controllers, permitting al- 
most limitless expansion of on-line storage and other in- 
put/output equipment , . . . 


Sixteen high speed integrated circuit registers also help 
improve program execution. Depending on program re- 
quirements, these registers can serve as accumulators, 
normal memory location, and/or index registers. Inter- 
mediate results of computations are stored in the regis- 
ters rather than in core memory; thus, no instructions 
are needed to store and retrieve the data and data is 
available in nanoseconds. Fifteen of the registers can be 
used as fast memory locations so that program segments 
with sixteen or fewer instructions can be executed repet- 
itively at very high rates. 




The single-user system in Figure 1 can be simple or 
as elaborate as the user requires. As shown, it consists of 
an arithmetic processor, one or more core memory mod- 
ules, a DECtape control and DECtape units*, a console 
teletype, and a paper tape reader and punch. By adding 
more core memory and data line scanner, the system can 
easily be converted to multi-programming. x 


The small swapping system shown in Figure 2 can be 
expanded in eight user groups to the large time-sharing 
system (Figure 3) which can handle up to 63 users. 
The large system includes file storage and swapping stor- 
age units, additional memory, and more peripheral 
equipment. For very large systems, a file storage disk 
may replace or supplement the disk packs. A computer- 
based communication system may be substituted for the 
data line scanner, and synchronous data phone units can 
be used to connect the system to remote batch devices 
and other computers. 
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FIGURE 3. LARGE SWAPPING SYSTEM 


The dual processor system in Figure 4 is one of many 
possible multi-processor configurations that the user can 
tailor his monitor to meet. Since the system shares both 
peripherals and core memory, both processors can access 
memory at the same time and can compute in parallel: 
Such an arrangement doubles the computing power of a 
single processor and more than doubles cost/effective- 
ness, since the cost of the additional processor is only a 
small fraction of overall system cost. 


FIGURE 2. 8-USER SWAPPING SYSTEM 
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courses. 


In other multi-processor systems, the processors may 
work independently or communicate through shared 
memory. One may serve as the input/output processor 
while the other performs most of the calculations. Or the 
processors can share all input/output and processing. 
Multi-processor systems can also combine a PDP-10 
arithmetic processor with other DIGITAL computers. 

\ 

\ In Summary 

The PDP-10 exemplifies the versatility required for to- 
day’s large computing tasks. With its 366-instruction 
repertoire, re'-entrant software, multi-progr amm ing hard- 
ware, and flexible priority interrupt system, it provides 
power and excellent response for a multitude of applica- 
tions. And with the system’s wide range of hardware and 
software, the user can purchase to serve present needs, 
yet easily expapd to meet future system requirements. 
Every PDP-10 is backed by service — software support 
for a full range of customer assistance, service through 
a worldwide system of over 60 service centers, and for- 
mal training through a variety of available tr ainin g 


At a cost Of less than half that of comparable systems, 
the PDP-10 provides the best price/performance avail- 
able today — another step toward Digital Equipment 
Corporation’s goal of providing the most for every com- 
puting dollar. 
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FIGURE 4. DUAL PROCESSOR SYSTEM 






INTRODUCTION 


SYSTEM DESCRIPTION 


DEC PDP-IO software is divided into eight functional groupings with respect to common programming 
activities, as follows: 


a. Source Program Preparation , 

b. Conversational Language Translators 

c. Program Loading and Library Facilities 

d. Debugging 

e. Utilities 

f. Calculators 

g. Batch Processing 

h. Monitoring 


Groups a through g are programs called CUSPs (commonly used system programs) and are run 

under control of the Single-User, Multiprogramming non-disk. Multiprogramming disk or Swapping Monitor. 


Source Program Preparation (EDITOR, LINED, TECO) 


The DECtape Editor, LINED (Line Editor for Disk), and the Text Editor and Corrector (TECO) programs 
can be used to create (and later correct or modify) text files (e.g., Macro-10 and FORTRAN source 
language programs) for subsequent assembly or compilation. Editor creates and modifies files on DEC- 
tape;, LINED creates and modifies files on disk; and TECO performs more complex editing functions on 
any standard I/O devices. 

■ • 


Language Translators (MACRO, F40) 

The Macro-10 Assembler (MACRO) and the FORTRAN Compiler (F40) translate source programs wrifl&n 
in the Macro-10 and FORTRAN IV languages, respectively, into binary machine language forsubse- 

■ * ■ ' ■ ’ i / ' / ■ • . 'rv ■■I's-tht/t.*' ■ 

quenf loading and execution. 
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Program Loading and Library Facilities (LOADER, LIB40, JOBDAT, FUDGE2) 

Loading is performed by the Linking Loader, which loads specified relocatable binary programs in core, 
links their references to each other, and searches the appropriate subroutine libraries (e.g., LIB40) for 
required subroutines. A job data area (JOBDAT) is created by the Loader for each program; this area is 
used to store the current status of the job during execution. Library files of binary programs can be up- 
dated by use of the File Update Generator (FUDGE2). 



Debugging (DDT, CREF, GLOB) 


After a program is compiled (or assembled), it can be loaded in conjunction with the Dynamic Debugging 
Technique (DDT) program and debugged. DDT allows the user to control program execution and to 
modify the program in any of several modes, including symbolic. For purposes of further program anal- 
ysis (and for documentation), the user can use the Cross Reference Listing (CREF) program, which pro- 
duces a cross-referenced listing of all symbols within his Macro program, and the Global Cross-Reference 
Listing (GLOB) program, which produces one to three listings of all global symbols encountered in one 
or more programs. 


Utilities (PIP, CODE, SRCCOM, BINCOM) 


A variety of utility programs are available for general-purpose data handling. Among these programs 
are: the Peripheral Interchange Program (PIP), which transfers data between any standard I/O devices; 
Code Translator (CODE), which performs translations between standard ASCII codes and code of other 
manufacturers; Source Compare (SRCCOM), which compares two versions of an ASCII file; and Binary 
Compare (BINCOM), which compares two versions of a binary file. 


Conversational Languages (AID, BASIC) 


Two. problem-solving conversational languages for scientists, engineers, and students are included as 
part of the PDP-IO software: the Algebraic Interpretive Dialogue (AID), a program based on the RAND 
JOSS™algebraic language; and Advanced BASIC^ , a conversational language for scientific, business, 
and educational applications that includes among many other features a special set of matrix processing 
operations. 


™JOSS is the trademark and service mark of the RAND Corporation for its computer program and 
services using that program. 

® Registered, Trustees of Dartmouth College. >•: 



Procedure 


PASSWORD: 


Then type your secret password followed by a carriage return. The system witfrkeep it secret 
by not printing it on the paper. If the project-programmer number agrees with the password, 
you will be logged, and any messages of the day will be typed for you. 

Then, direct Monitor to load and start a program from the System Library (.R prog), start a • 
program already loaded in core (.START), discontinue your job (.KJOB), or perform any of 
a variety of other operations.. A complete list of Time-Shoring Monitor commands is given 
in Table 9-1 . 


Batch Processing (BATCH, STACK) 

The Batch Processor (BATCH) monitors the sequential execution of a series of user jobs with a minimum 
of operator attention; operates as one of the "users" in a time-sharing environment and runs concurrent- 
ly with the Batch-controlled jobs (as well as other jobs on the system); and permits constant communica- 
tion by the operator. Job Stacker (STACK) prepares input stacks for BATCH and processes output stacks 
from BATCH. • 


PDP-ft) software includes two major categories of Monitors: the Single-User Monitor (10/30 configura- 
tion) and the Time-Sharing Monitors (10/40 and 10/50 configurations). The latter category includes th« 
Multiprogramming non-disk Monitor (10/40), Multiprogramming disk Monitor (10/40) and the Swapping 
Monitor (10/50). The Swapping Monitor was used in the generation of all examples in this manual. 

The 10/30 Monitor is a subset of the 10/40 and 10/50 Monitor; They are compatible at the source and 
relocatable binary levels. The 10/40 and 10/50 Monitors are compatible at the source, relocatable 
binary, and saved core image levels. 

SYSTEM OPERATION 

The following basic procedures and rules are necessary to communicate with the Monitor and load and 
execute DEC commonly used system programs (CUSPs), as well as user programs. 


To establish communication with the Monitor, place the Teletype in Monitor Command Mode 
by typing t C (i .e./hold down the CTRL key while striking C; Monitor will respond with a 
period (.). If you have a 10/30 or a 10/40 system, skip the LOGIN procedure in the next 
step. 

Type LOGIN followed by carriage return. The system will respond with 
JOB n NAME OF SYSTEM _ 

followed by a number sign. Then type your project-programmer number, followed by a car- 
riage return. The system will then type 



All CUSP, (except EDITOR end LINED) supplied by DEC ere device Independent; therefore, the user 
must tell the CUSP, v,a a commend string typein, which devices to use. Reediness to receive o com- 
nmnd strin" is signelled by the CUSP vie on asterisk (*, typeout after loading. For example Ahen the 

FORTRAN IV Compiler has been called and it has responded with an asterisk, the user types in a 
command string indicating: 

, a ■ Th e device containing the source program to be compiled 

b. The device on which the binary output is to be placed hnd 

c. The device on which the compilation listing Is to be written 

^binary -output -device, listing-device - source-device 

Devices ore specified by a 3-character device name (a fourth character, a digit, specifies the particu- 
lar unit in the case of DECtapes, teletypes, and magnetic tapes), followed by a colon. 


Device 

Device Name 

Card reader 

CDR: 

Card punch 

CDP: 

Line printer 

LPT: 

Paper tape reader 

PTR: 

Paper tape punch 

PTP: 

Teletype 

TTY: or TTYn: 

DECtape 

DTAn: 

Magnetic tape 

MTAn: 

Disk 

. DSK: 


For file-oriented devices (DEC, ape and disk), a filename (maximum of six characters) is also repaired 
following the device name to specif/either the specific file to be read or the filename to be assigned 
o the output. A filename can be further specialized by adding a 3-character extensi'an name to it, 
prece ed by a period ( . ). Extension names are generally used to classify a file into a articular cate- 
Gory, and certain standard extensions are used and recognized throughout the system (e.g., .REL for 
relooctoble binary files, .SAV for saved core image files, .MAC for Macro-,0 source files,. ,F4 for 
FORTRAN source files, etc). The following example shows a sample FORTRAN command string. . 

Example: 

' 

DTA!:BIN.REL,LPT: - DTAO:SOURCE Com „.. ( , , . ■ ' 

Compile the file designated as SOURCE on DECtape 
0; write the binary output on DECtape 1, designa- 
tmg it BIN. REL; print the listing on the line printer. 

; y.r . - 

’ 

— lit 
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ALTMODE or PREFIX or ESC 


Strike the ESC key (sometimes Some os 33/ 
labeled ALTMODE or PREFIX) 

Hold down the SHIFT key while Strike [ key 
striking KV 


vm. 


TYPOGRAPHIC CONVENTIONS IN THIS MANUAL 

All computer typeouts or. underscored (single line) or enclosed in brockets (multiple lines). 
All operator typeiiis are not underscored. 


SYMBOLOGY USED IN CONSOLE EXAMPLES * 

,C Ho| d down the CTRL key while striking C. Normally echoes as tC. 1 

Nol d Nrech e o.7o" L .x e . y WhMe S,rikin9 ,h “ " X ; “ ey ' Where V «■ -y^orocter. 

i^zV he]r key *■'*-*“• 33, 3s, 


Key Designation 

Symbol in This 
Manual 

Models 33 and 35 

Model 37 

(@1) 

tR 

Hold down CTRL key while 
striking R. 

Same as 33/35 

^APE) (not-TAPE) 

IT 

Hold down CTRL key while 
striking T. 

Same as 33/35 

(BELL) 

IG 

Hold down CTRL key while 
striking G . 

Same as 33/35 

(JAB) (horizontal tab) 

H or tl 

Hold down CTRL key while 
striking I. 

Strike TAB key 

^OR^) 

tL 

Hold down CTRL key while 
striking L. 

Same as 33/35 

<2D (vertical tab) 

tK 

Hold down CTRL key while 
striking K. 

Same as 33/35 

(XON) 

1 ' 

IQ 

(Initialize paper tape reader 
input.) Hold down CTRL key 
while striking Q. 

Same as 33/35 

✓ 

(XOFF) ■ • 

IS 

(Terminate paper tape reader 
input.) Hold down CTRL key 
while striking S. 

w 

Same as 33/35 * 



Hold down the SHIFT key 
while striking O. 

Strike -key 

RETURN 

) 

Strike the RETURN key. 
Normally echoes back as a 
carriage return, line feed. 

Same as 33/35 



nbol in 1 
Manual 


Models 33 and 35 


Model 37 


Hold down the SHIFT key while. Strike ] key 
striking M. 

When appearing alone (as in Strike t key 
DDT), hold down the SHIFT 
key while striking N. 

Hold down the SHIFT key while Strike < key 
striking ", 

Hold down the SHIFT key while Strike > key 
striking " . . 

Strike the LINE-FEED key. 

Strike the RUBOUT key. Nor- 
mally echoes back as a back- 
slash (\), XXX, ora repeat 
of the character erased . 

Hold down the SHIFT key 
while striking L. 

Strike the space bar to space Same as 
to indicated position. TAB 
can also be used in most in- 
stances. 


Strike LINE SPACE key 
Strike DELETE key 


RUBOUT 


1UBOUTJ 


SPACE BAR 



DEMONSTRATION PROGRAMS 

The following demonstration programs illustrate the simplicity and flexibility of a PDP-10 software system: 

a. Demonstration is a typical example of the procedure for creating a FORTRAN main pro- 

gram source file and a Macro-10 subprogram file. These two files are then translated, loaded, 
and executed together. A bug is encountered during execution, and the DDT (Dynamic De- 
bugging Technique) program is used to correct the erroneous instruction. The programs are now 
executed successfully, their core image is saved for future execution, and the original .source 
file is altered to reflect the correction made to the binary code. f- 

b. Demonstration # 2 is a more complex example. The sequence of operations is similar to 
that of Demonstration # 1 (source program file creation, translation, loading, execution, de- 
bugging, saving the core image, and altering the source code to reflect changes made to the 
object code). In addition, such procedures as leaving the current job, logging in and begin- 
ning a second job, and then later returning to the original job are included. Figure 1-1 con- 
tains the flow diagram for Demonstration ^2. 
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IN PUT-OUTPUT CODES 


I 

Even 

7-Bit 


v f . 

" Parity 

Octal 


Bit 

Code 

Character 

!•• ' 

0 

000 

NUL 

p 1 

1 

001 

SOH 


1 

002 

STX 

C ' l • 

0 

003 

ETX 


1 

004 

EOT 

1 • 1 

0 

005 

ENQ 

im . > 

m . 

,m 1 

0 

006 

ACK 

1 

1 

007 

BEL 

H i 

1 

010 

BS 

j 1 

0 

011 

HT 

8 

0 

012 

LF 

fp!.;- 

_ 

1 

013 

VT 


0 

014 

FF 

1 i 

1 

015 

CR 


1 

016 

SO 

B 

0 

017 

SI 


1 

020 

DLE 


0 

021 

DC1 

1 

0 ’ 

022 

DC2 

I* 

.1 

023 

DC 3 

■ 

1: 

0 

024 

DC4 

«; . ■ ‘ 

1 

025 

NAK 

iJSt.V 


1 

026 

SYN 

0 

027 

ETB 


0 

030 

CAN 


I 

031 

EM 

f 

l 

032 

SUB 


0 

• 033 

ESC 
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TELETYPE CODE 


Null, tape feed. Repeats on Model 37. Control shift P on Model 35. 

Start of heading; also SOM, start of message. Control A. 

Start of text; also EOA, end of address. Control B. 

End of text; also EOM, end of message. Control C. 

End of transmission (END); shuts off TWX machines. Control D. 

Enquiry (ENQRY); also WRU, “Who are you?” Triggers identification 
(“Here is . . . ”) at remote station if so equipped. Control E. 

Acknowledge; also RU, “Are you . . . ?” Control F. 

Rings the bell. Control G. 

Backspace; also FEO, format effector. Backspaces some machines. 
Repeats on Model 37. Control H on Model 35. 1 

Horizontal tab. Control I on Model 35. 

Line feed or line space (NEW LINE); advances paper to next line. Repeats 
on Model 37. Duplicated by control J on Model 35. 

Vertical tab (VTAB). Control K on Model 35. 

Form feed to top of next page (PAGE). Control L. 

Carriage return to beginning of line. Control M on Model 35. 

Shift out; changes ribbon color to red. Control N. , 

Shift in; changes ribbon color to black. Control O. 

Data link escape. Control P (DCO). 

■ Device control 1 , turns transmitter (reader) on. Control Q (X ON). 

Device control 2, turns punch or auxiliary on. Control R (TAPE, 
AUX.ON). ' 

Device control 3, turns transmitter (reader) off. Control S (X OFF). 

Device control 4, turns punch or auxiliary off. Control T (TAPE, 
AUX OFF). . 

Negative acknowledge; also ERR, error. Control U: 

Synchronous idle (SYNC). Control V. 

End of transmission block; also LEM, logical end of medium. Control W. 
Cancel (CANCL). Control X. 

End of medium. Control Y. 

Substitute. Control Z. . . 

Escape, prefix. This code is generated by control shift K on Model 35, 
but the Monitor translates it to 175. 

File separator. Control shift L on Model 35. - 

Group separator. Control shift M on Model 35. 


I 


mm 


■'it* 

liife 




- 

v .. 



."VS „****«.•, 



ift N on Model 35. 
O on Model 35. 


Repeats on Model 37. 
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TELETYPE CODE 


Even 

7-Bit 



Parity 

Octal 



Bit 

Code 

Character 


0 

036 

RS 

Record separator. Control sh 

1 

037 

US . 

Unit separator. Control shift 

1 

040 

SP 

Space. 

0 

041 

i 

i 

0 

042 

" 

\ 

1 

043 

# 


0 

044' 

$ 


1 

045 

% 


1 

046 

& 


0 

047 

' 

Accent acute or apostrophe. 

0 

050 

( 


1 

051 

> 


1 

052 

* 

Repeats on Model 37. 

0 

053 

+ 


1 

054 

, 


0 

055 

- 

Repeats on Model 37. 

. 0 

056 


Repeats on Model 37. 

1 

057 

/ 


0 

060 

0 V 


1 

061 

1 


1 

062 

2 


0 

063 

3 


1 

064 

4 



Remarks 





Remarks 


. 


INPUT-OUTPUT CODES 


Even 7-Bit 

Parity Octal 
Bit Code Character 


Repeats on Model 37. 


Shift K on Model 35. 
Shift L on Model 35. 
Shift M on Model 35. 

Repeats on Model 37. 
Accent grave. 



Remarks 


REFT 


Even 7-Bit 

Parity Octal 
Bit Code Character 


l .177 DEL 


PAPER ADVANCE 
LOCAL RETURN 
LOCLF 
LOC CR 

INTERRUPT, BREAK 
PROCEED, BRK RLS 
HERE IS 


Repeats on Model 37. 


This code generated by ALT MODE on Model 35. 

This code generated by ESC key (if present) _ on Model 35, but the 
Monitor translates it to 175. 

Delete, rub out. Repeats on Model 37. 

a t ' ■ ’ . • ' . *7 /■« • 

Keys That Generate No Codes 

Model 35 only : causes any other key that is struck to repeat continuously 
until REPT is released. 

Model 37 local line feed. 

Model 37 local carriage return. 

Model 35 local line feed. 

Model 35 local carriage return. 

Opens the line (machine sends a continuous string of null characters). 
Break release (not applicable). 

Transmits predetermined 21-character message. 



. - 


PDP-10 

* Character ASCII DEC 029 


PDP-10 

Character ASCII DEC 029 DEC 026 


DEC 026 


None 
118 2 
8 7 
8 3 

118 3 
0 8 4 
12 
8 S 
12 8 5 
118 5 
118 4 
12 8 6 
0 8 3 
11 

12 8 3 
0 1 


8 4 
12 1 
12 2 
12 3 
12 4 
12 5 
12 6 
12 7 
12 8 
12 9 
11 1 
11 2 
11 3 
11 4 
11 5 
11 6 
11 7 
11 8 

11 9 
0 2 
03 
0 4 
0 5 
0 6 

07 
0 8 
0 9 

12 8 2 
118 7 

08 2 
.12 8,7 
0 8 5- 


8 4 
12 1 
12 2 
12 3* 
12 4 
12 5 
12 6 
12 7 
12 8 
12 9 
11 1 
11 2 
11 3 
11 4 
11 5 
11 6 

11 7 
11 8 
119 
0 2 
0 3 
0 4 
0 5 
06 
0 7 
0 8 
0 9 
118 5 
8 7 

12 8 5 
8 5 

8 2 


8 2 
118 6 
12 8 4 
8 6 
0 8 6 
0 8 7 


7 9 

12 0 2 4 6 8 
12 11 0 1 


Binary 
Mode Switch 
End of File 


The octal codes given above are those generated by the Monitor from the column punches. The card 
reader interface actually supplies a direct binary equivalent of the column punch, asJisted in the following, 
two pages. . 


INPUT-OUTPUT CODES 


CARD CODES 


None 
12 8 7 
0 8 5 
0 8 6 
118 3 
0 8 7 
118 7 
8 6 

0 8 4 a 
12 8 4 ' a 
118 4 

12 

083 

11 

12 8 3 
0 1 
0 

1 
2 

3 

4 

5 

6 

7 

8 
9 

11 8 2 or 11 0 
0 8 2 

12 8 6 
8 3 
118 6 

12 8 2 or 12 0 


: '*5 



Column 

Punch 

None 

0 

1 

2 

3 

4 

5 

6 

7 

8 
9 

12 1 
12 2 
12 3 
12 4 
12 5 
12 6 
12 7 
12 8 

Column 

Punch 

12 

11 

12 0 
11 0 
8 2 


Character 

Space 

0 

1 

2 

3 

4 

5 

6 

' 7 

8 
9 

B 

C 

D 

E 

F 

G 

H 

026 Data 
• Processing 


CARD CODES 

Octal 

0000 

1000 

0400 

0200 

0100 

0040 

0020 

0010 

0004 

0002 

0001 

4400 

4200 

4100 

4040 

4020 

4010 

4004 

4002 

026 

Fortran 029 


Character 

I 

J 

K 

L 

M 

N 

O 

P 

Q 

R 

/ 

S 

T 

U 

V 
W 
X 

Y 
Z 


DEC 029 


Column 

Punch 

12 9 
11 1 
11 2 
11 3 
11 4 
\ 11 5 


Octal 

4000 


5000 


Octal 


4001 i 
2400 
2200 
•2100 
2040 
2020 
2010 
} 2004 

I 2002 
’ 2001 
1400 
1200 
1100 
1040 
1020 
1010 
1004 
1002 
1001 



INPUT-OUTPUT CODES 


Column 

Punch 


026 Data 
Processing 


026 

Fortran 


DEC 026 DEC 029 


12 8 7 
118 2 
11 8 3 
11 8 4 
118 5 
11 8 6 

11 8 7 
08 2 
0 8 3 
0 8 4 
08 5 
086 
087 

12 11 0 1 
12 0 2 4 6 8 
7 9 


See note 


End of File End of File 
Mode Switch Mode Switch 
Binary Binary 


Note: There is a single key for the 0 8 2 punch on the 029 but printing is suppressed. 

The Monitor translates the octal code for the 12 0 punch in DEC 026 to 4202 (which corresponds to 
12 8 2 punch), and the code for 1 1 0 to 2202 (1 1 8 2 ). 


'*•>- .V ■ 






APPENDIX C 



MISCELLANY 


Instruction Flow Simplified 


Word Formats 


Instruction Tuning Flow Chart 
In-out Device Bit Assignments 


Indicator Panels . 


Powers of Two 



* ■ - 
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meant that the job initiated from that console is in a detached 
mode. By typing an appropriate command, the job may be attached 
to the same console or to any other console in the system. 


Monitor Mode and User Mode 


From the user's point of view, his console is in one of 
two states - monitor mode or user mode. In monitor mode, each 
line the user types in is sent to the Monitor Command Interpreter, 
The execution of certain commands (as noted in the tables below) 
places the console in user mode. Once the program is in user 
mode, the console becomes simply, an input/output device for that 
user. In addition, user programs will use the console for two 
purposes. The user program will accept command strings from the 
console or will use the console as a direct input/output device. 
Example : 


monitor mode 


monitor command 


user mode 


*DSK:FOO«-TTY 


user program command 
string 


THIS IS FILE FOO+Z 


user program using 
console as an input 


monitor mode 


R MACRO 


monitor command 


*TTY : ,-«-DSK:PR0Gl 


user program command 
string 


user mode 


user program using 
console as an output 
device ’ • 


The special character +C (produced by typing 
CONTROL Key depressed) is used to stop a user program 1 
the console to monitor mode. There are certain commanc 

2-2 . 


C with the 




cause the user program to start or continue running (as noted in 
the tables below) but which leave the console in monitor mode. 

When the system is started, each console is in monitor 
mode ready for users to begin typing in commands. However, if 
the system becomes fully loaded (i.e., all the jobs that the 

system can accommodate have been initiated) , then any unused con- 
soles enter a special state ,, ... 


2-2 COMMAND I NTERPRETER AND COMMAND FORMAT 

Each command is a line of ASCII characters in upper 
and/or lower case. Spaces and non-printing characters preceding 
the command name are ignored. The Monitor Command Interpreter 
will not interpret or execute a line of comments preceded by a 
semicolon. Every command to the Monitor Command Interpreter must 
be terminated by pressing the RETURN key on the console. If the 
command is not understood, an error message is typed out by the 
Monitor and the mode is unchanged. 


command names are strings from one to six letters, 
after the sixth are ignored. Only enough characters 
identify the command need be typed, in the tables 
'W, the commonly used abbreviation of the command nam< 
Installations which choose to implement additional 


is shown 


commands should take 
few letters of exist: 


command name 

l 2— 3 . r , • 
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The user's command is not executed 


“ nonl “ r command Interpreter recognizes a com- 
mand that requires all devices to be inactive and the job has 
devices actively transmitting data to or from its core area, the 
execution of the command will be delayed until the devices are 
inactive. A command is also delayed if a job is swapped out to 
the disk and the command requires core residence. It will be ’ 
executed when the job is returned to core. 


2 - 2 - 7 Completion-of -Command Signal 

Most commands are processed without delay 
of each command is signaled by the output of a carr 
line feed. If the console is left in Monitor mode, 
follows the carriage return, line feed. If the 


The completion 


in user mode, any response other than the 
feed comes from the user's program. For < 


isterisk (*) to the user’s console 
accept user-mode command strings. 


SYSTEM ACCESS CONTROL COMMANDS 


Access to the system is limited to authorized personnel 
The system administrator provides each authorized user with a 

I 

.project number^ a programmer number, and a password. The project 
and programmer numbers are octal numbers up- to six digits each. 
The project-programmer/numbers will identify not only the user 
but also his file storage area on the. disk. The password is from 
one to five ASCII characters. To LOGIN successfully the project- 




programmer numbers and the password typed in by the user must 


match the project-programmer numbers and password stored in th< 


system accounting file (ACCT.SYS [1,1] ) 


Monitor Command to Gain Access to the System 


Explanation 


Monitor Messages 


Command 


LOGIN initializes a Monitor routine 
to accept the user's LOGIN data-. 


LOGIN . PLEASE 


LOGIN 


The following is the procedure used 
to gain access to the system. 


LOGIN 


Job number assigned 
to user, followed by 
Monitor name and 
version number. 


System types out num- 
ber sign to indicate 
user should type his 
project-programmer 
number . 


User types in his 

project-programmer 

number 


System requests user 
to type his password. 
User ’types password, 
followed by carriage 
return. To maintain 
password security, 
the Monitor will not 
echo the password. 


PASSWORD 


If user entries are 
correct. Monitor 
responds with time, 
date, TTY number, +C 
k^nd a period, indica- 
ting readiness to 
accept a command; 


•Characteristics: ’ 

d = places job in detached mode I* ■ LOGIN required (Disk Monitor) 

m = places job in Monitor mode A = no active device , ; , [■ 

u = places job in user mode C » core required ■ ‘ ■ ' '\,l 

J * requires a job number. ' • 

R =* runs a CUSP thereby replacing previous program in user's 'n 

~ addressing space. • '/.£ 

D = available only in Multiprogramming Disk and irr swapping 
systems, not in Multiprogramming non-disk systems. 







The Monitor allocates peripheral devices and core . 
memory to users upon request and protects these allocated facili- 
ties from interference by other users. The Monitor maintains a 
pool of available facilities from which a user can draw. 

A user should never abandon a time-sharing console 
without returning his allocated facilities to the Monitor pool. 

Until a user returns his allocated facilities to the pool no } 

h • i 

other users may utilize them. j 

All devices controllable by the system are listed in 
Table 5-1. Associated with each device is a physical name, con- 
sisting of three letters and zero to three numerals to specify 
unit number. A logical device name may also be assigned by the 
user. This logical name of one to six alphanumeric, characters of 
the user's choice is used synonymously with a physical device 
name in all references to the device. In writing a program, the 
user may use arbitrarily selected device names which he assigns 
to the most convenient physical devices at runtime. All refer- 
ences to devices 







Table 2-2 


Monitor Commands to Allocate Facilities 


Explanation 


Monitor Messages 


ASSIGN 1 
phys-dev 
log-dev 


The user has previously 
assigned this logical 
name to another device. 


Returns one or more devices currently 
assigned to the user's job to the 
Monitor's pool of available devices. 


If this argument is not 
specified, all devices 
assigned to the user's job 
are deassigned. 

If this argument is speci- 
fied, it can be either the 
logical or physical device 
name • ' 


Allows one job to pass a device to a 
second job without going through the 
Monitor device pool. 


The physical or logical 
name of the device to be 
reassigned. Cannot be a 
user console. - 


The number of the job to 
which the device is to be 
reassigned. 













CORE n 


Total number of IK blocks 
of core to be assigned to 
the job from this point on, 


number of IK 
blocks in low 
segment 
number of IK 
blocks in high 
segment 

maximum K per job 
swapping systems- 
max.. physical, user 
core 

non- swapping sys- 
tems - free + 
dormant core 
number of K 
unassigned in 
core and swapping 
device 


If n is omitted. Monitor 
types out the same re- 
sponse as when an error 
occurs, but does not change 
core assignment. 


NO SUCH DEVICE 
Either the device does 
not exist or it w&s not 
assigned to this job. 


BUSY 

The console addressed is 
either (1) .not in the 
Monitor mode or (2) is 
not positioned at the 
left margin. 


Monitor Messages 


TALK dev 


FINISH 

dev 


10/40 Systems: 
m/p 

10/50 Reentrant Systems: 
nrt-n/p CORE 
VIR. CORE LEFT=V 


F Terminates any input or output cur- 
, rently in progress on the device. 

dev The logical or physical 

' name of the device on 4 
which I/O is to be ter- 
minated. I 

i If no name is specified, 

I/O is terminated on all 
devices assigned to the 


To allow the user to type directly to 
another user's console. , 

dev Must be one of the follow- 

ing: 

CTY - Console 
Teletype 


(OPR is never busy.) 


To modify the amount of core assigned 
to the user's job. 


TTYn - Where n can be in 
the range of 0 
through 77. 


- Operator's console 
(the Teletype desig- 
nated as such when 
the Monitor was 
initialized) . 


The low and high segments 
disappear from the job's 
virtual addressing space. 









Monitor Messages 


To print out all the available devices 
(except TTY's) and the number of free 
blocks on the disk. 


'Refer to footnote in Table 2-1 


If DTA or MTA is used 


. 'the Monitor performs a search for an available 

drive and then types out DTAn (qr MTAn) ASSIGNED. 









■ ■» . ■ 


ft.. 


■■- 


User then 
types 


*PTP : -*-ABC : FOO 


(command string to 
PIP asking that file 
FOO be transferred 
from device ABC 
(which is now 
assigned as DTA6) to 
device PTP (wh^ch is 
assigned to user) . 


The user does not type the period or the asterisk. 
The period is the Monitor response to the user and 
the asterisk is the CUSP response. The user must 
terminate every command to the Monitor Command 
Interpreter by pressing the RETURN key on the 
Teletype. 


SOURCE FILE PREPARATION COMMANDS 




jaba/ia* t*-*#*^**.: .rr l .*T*rtttr..W.<in * m>w^> rr.w , . 




■B I 


Command 


The COMPIL CUSP cannot decipher the 
comm arid . 


Device DSK: could not be initial- 
ized. 


Table 2-4 

Monitor Command Diagnostic Messages 
(For File Manipulation Commands) 


Monitor Commands to Prepare Source Files 


ExDlanation 


Monitor Messaaes 


Runs LINED (Line Editor for Disk) and 
opens an already existing sequence- 
numbered file on disk for. editing. 


See Table 2-4 


Runs LINED and opens a new file on. 
disk for creation. 


See Table 2-4 


CREATE 
file. ext 


Runs TECO (Text Editor and Corrector) 
and opens an already existing non- 
sequence-numbered file on disk for 
editing . 


See Table 2-4 


TECO 

file. ext 


Runs TECO and opens a new file on disk 
for creation. 


See Table 2-4 


MAKE 

file. ext 


Refer to footnote in Table 2-1 


Meaning 


Message 


COMMAND ERROR j 







Table 2-4 (Cont) 

Monitor Command Diagnostic Messages 
(For File Manipulation Commands) 


Meaning 

Errors detected during assembly, 
compilation, or loading prevent a 
program from being executed. 
Loading will be performed, but 
LOADER will EXIT to the Monitor 
without starting execution. 

A temporary command file could nol 
be entered in the user's UFD. 

I/O error occurred while reading i 
temporary command file from the 
disk . 


EXECUTION DELETED 
(typed by LOADER) 


INPUT ERROR 


LINKAGE ERROR 


I/O error occurred while 
CUSP from device SYS : . 

The @ construction exceec 
of nine; may be due to a 
@ command files. 


NESTING TOO DEEP 


NO SUCH FILE 


Specified file could not be foi 
(may be a source file or a fill 
quired for operation of COMPIL 
CUSP) . 


NOT ENOUGH CORE 


OUTPUT ERROR 


PROCESSOR CONFLICT 


TOO MANY NAMES or 
TOO MANY SWITCHES 


UNRECOGNIZABLE SWITCH 



****&&&& Nfe* 




... ■■■■■■■ 


Table 2-5 


Cfr^Monitor Messages 


TYPE list 


See Table .2-4 


All files 


TYPE FILEA, DTAO : FILEB . MAC 
TYPE A,DTA4 :B,C[15,107] 


If dev: is omitted or DSK:, directory li: 
of iiser's disk files is. typed on the use; 

o?hS e nprJ f DTAn: is specified, direct 
of that OECtape is typed. 

Two switches can be used with the DIRECT 
command: 

/F List short form of directory (i.e 
dates) 

■/L List on line printer (LPT) instead c 
Teletype. 

The : may be omitted in dev. 


2,6 file manipulation COMMANDS 

Each of the following .commands performs complex func- 
tions which would require a number of commands on a less sophis- 
ticated system. The commands in Table 2-5 list the user's files 
and file directories and cause his source files to be compiled, 
loaded, and executed. 


Monitor Commands to Manipulate FiJ.es 


| Explanation 

TY Directs PIP (Peripheral Interchange Program) 
to type contents, of named source file(s) on 
user's Teletype. 

llst A single file specification, or a 

string of file specifications 
separated by commas. A file 
specification is the same as that 
described for COMPILE, LOAD, 
EXECUTE, and DEBUG commands. In 
addition, the * construction can 
be used as follows: 

filename.* All files with this 
filename and any 
extension 

*.ext All files with this • 

• extension and any 

filename 


LIST list L'l Directs PIP to list contents of named source 
tile(s) on the line printer (LPT). 

Examples: LIST TEST.* 

LIST *. MAC 

LIST DTA4 :A,B,C . . . 




Monitor Messages 


Deletes one or more files from i 
DEC tape, if a device name is si 
remains in effect until changed 
command string is reached. 


RENAME 


Changes the name of one or more fil 
or DEC tape. The arg is a pair of 
fications separated by an = sign, o. 
of such pairs separated hy commas: 

RENAME newl = oldl,new2 = old2 

Device names can be specified only \ 
new filename and remain in effect ui 
changed or end of command string is 


See Table 2-4 


See Table 2-4 


COMPILE 

list 


Produces' relocatable binary file(s) for the 
specified program(s). The use of the MACRO 
assembler and/or the FORTRAN IV compiler is 
determined as follows. 


Condition 

If no .REL (binary) 
file 


Action 

Translate source file 


If source-file (date 
time) is later than 
binary-file [date, 
time) 


Translate source file 


If other than above 


Do not translate 
source file; use cur- 
rent .REL (binary) 
file. 


Translator Used 
MACRO assembler 
FORTRAN IV compiler 
(F40) 


Other than above, or 
null 


Standard processor" 
is used (see 2.6.2) . 

m *y be a single file 
specification, or a string of file specifica- 
tions separated by commas. A file specifica- 
tion consists of a filename (with or without 
an extension) and may include a device name 
(if the source file is not disk) or a project 
programmer number (if the source file is not 
xn the user's disk area). 

Examples: 

=n^^'r^ OG1 - MAC ' PROG1 - r ‘ , - I ' ROG1 - xlf Z-DTAO : PROGl 

PR0G1 [10,16] ,PROGA,DTAO:PROGB 

PROGC.MAC 







Commands 


Explanation 


Monitor Messages 


LOAD list 


Performs the COMPILE function 
fxed program (s) , then runs LO; 
the .REL files. 


See Table 2-4 


COMPILE and LOAD functions for 
program (s) and begins -execution 

Droaram. ■ 


DEBUG list 


^ rf ^”f- the COMp H‘E.a"<l LOAD functions and, 
in addition, prepares for debugging. DDT (t 
Dynamic Debugging Technique program) is load 
followed by the user's programs with 
of loading?* 5 * ° DT ls entered on “"Potion 

Examples:- 

COMPILE PROGA 

EXECUTE DTA1 : TEST. MAC 

DEBUG/L FILEA , FILEB.FILEC/N.yiLED 

liSti " 9S £ ° r FILE A,FILEB,and FILED, 


see 2.6.2) 

LOAD FILEA, FILEB, %60000FILEC 

(Pass origin switch to LOADEI 
Switches" 2.6.4) 


Refer to footnote in Table 2-1 


Each time a COMPILE , LOAD, EXECUTE, or DEBUG COMMAND 
is executed, the command with its arguments is "remembered" as a 
file on the disk. Because of this, the filename last used may' 
be recalled for the next command without specifying the arguments 
again. • (See last paragraph in Section 2.5) . 

Extended Command Forms . 

The commands shown in Table 2-5 are adequate for the 
compilation and execution of a single program or a small group 
of programs at one time. However, the assembly of large groups 
of programs, such as the- FORTRAN library or the Time-Sharing 

2-17 
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. a) Spaces are used to delimit words but are otherwise 
ignored. Similarly, the characters TAB, VTAB, and FORM are 
treated like spaces. \ 

b) The characters CARRIAGE RETURN, LINE-FEED, AND 
ALTMODE are ignored if the first non-blank character after a 
sequence of returns, line-feeds, and altmodes is a comma, other- 
wise, they are treated either as commas >y the COMPILE, LOAD, 
EXECUTE, and DEBUG commands or as command terminators by all tile 
other commands appearing in Tables 2-3 and 2-5 ■ I 

c) Blank lines are completely ignored since strings 
of returns and line-feeds are considered together. 

d) Comments may be included in command files by pre- ' 
ceding the comment with a semicolon. All text from the semicolon 
through the line-feed is ignored. 

z e) If command files are sequenced, the sequence num- 

bers are ignored. 

2. 6. 1.2 The Construction 1 

A single relocatable binary file may be produced from 
a collection of input 'source files by means of the ■+■ construc- 
tion. For example, a use f may wish to compile the parameter 
file, S .MAC , the switch file, FT50SB.MAC, and the file that is 
the body of the program, APRSER. MAC. . This is specified by the 
following command: 

^ COMPILE S + FT50SB + APRSER 

The name of the last input file in the string is given to any 

output (.REL and/or .LST) files (e.g., APRSER. in the foregoing 
example) . The source files in the '•*« construction may each con- 

Used in COMPILE, LOAD, EXECUTE,, and DEBUG commands only. 

■ v.VyW w* ^ . . v '•< .■ , 

i , „ V:'', 

' ,• 'v 
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tain device and extension information 
numbers. 


Usually the filename of the binary file is the same a: 
that of the source file, with the extension specifying the dif- 
ference. This can be changed by use of the "=» construction, 
which allows a filename other than the source filename to be 
given to the output file. For example, if a binary file is 
desired with the name BINARY. REL from a source program with the 
name SOURCE. MAC, the following command is used. 

COMPILE BINARY = SOURCE 

This same technique may be used to specify an output name to a 
file produced by use of the •+■ construction. To give the name 
WHOLE. REL to the binary file produced by PARTI. MAC and PART2 .MAC 
the following is typed. 


COMPILE WHOLE = PARTI + PART 2 


programs within the 


ickets to be assembled with the sa 
sed, it must appear before the <> 
to assemble the files LPTSER.MAC, 
•C, each with the parameter file S 


COMPILE S' + LPTSER, S + PTPSER, S + PTR, 
But -by using the angle brackets , the command becomes 
COMPILE S +<LPTSER, PTPSER, PTRSER> " " 
The user cannot type 


R,PTRSER>+- S • 

and DEBUG commands only 

‘ ■ .<S ; ' 


. ■ 




The COMPILE, LOAD, EXECUTE, and DEBUG commands may be 
modified by a- number of switches. Each switch is preceded by a 
slash (/SWITCH) and is terminated by any non-alphanumeric charac- 
ter, usually a space or a comma. An abbreviation may be used as 
long as it uniquely identifies a particular switch. 

These switches may be either temporary or permanent. 

A temporary switch is appended to the end of the filename, with-} 
out an intervening space, and applies only to that file. 

Example: COMPILE A,B/MACRO,C (The MACRO assembler 

applies only to file B) 

A permanent switch is set off from filenames by s R aces, 
commas or any combination of the two. It applies to all the' 
following files unless modified by a subsequent switch. 

Example: - 


COMPILE A , /MACRO , B , C 


COMPILE A /MACRO B,C 


COMPILE A, /MACRO B,C 


2 - 6 . 2 . 1 Compilation Listings 

Listing files may be generated by the use of switches 
The listings may be of the ordinary or the oross-reference type. 
The operation of the switch produces a disk file with the ex- 
tension .LST. 


'LIST" and "NOLIST 


and non-listing of- programs . These -sw 
either temporary or permanent switches. 


LOAD, EXECUTE 



COMPILE /LIST A,B,C 


Will generate listings of all three programs. 


COMPILE A/LIST, B,C 

Will generate a listing only of program A. 

COMPILE /LIST A, B/NOLIST, C 

will generate listings of programs A and C. ■ 

The compile-switch "CREP" is just like "list", except $ 

that a cross-reference listing is generated,, to be processed 

later by the program "CREF". •' 9 

. ■ 

Unless the /LIST or /CREP is specified, no listing 

'"I" “ 9e "“ ated - The LIST c °“ used to obtain printer | 
output of regular listing files and the CREP command to obtain i 
printer output of CREP listing files. 

Since the "LIST", "NOLIST",. AND "CREF " switches are so 4 
commonly used, the switches "L", "N" , and - c . are defined ^ M 

the corresponding meanings, even though there are (for instance) 1 
ther switches beginning with the letter " L" . Thus the command J 
COMPILE /L A 

produces a listing file "A.LST" (as well as ■ jS 

1 weJ " L as ' °f course, "A.REL") 

2 - 6 - 2 - 2 The "Standard Processor " ,'M 

The "standard processor" is used to compile or assemble l| 
programs which do not have the extensions .MAC, .F 4 , or .rel. ' M 
. There are a number of switches for setting the "standard 
processor", if all source files are kept with the appropriate U 
extensions, this subject can" be disregarded. 

If the command 
COMPILE A 

is executed and there is a file named "A. "(that is, with a blank *9 





These switches may be used as "temporary" or "per- 
manent . For example, assume that programs A, B, and C exist on 
the disk, with blank extensions. Then 
COMPILE A, B/M, C. 

will cause A and C to be translated by FORTRAN, B by MACRO. 
COMPILE A, /M B, C 

will cause A to be translated by FORTRAN, B and C by MACRO. 

I 

NOTE ! 

Programs with .MAC and .F4 extensions are always translated tav ; 
the, extension rmplied, regardless of the "standard lessor " 

' ' '' — r ,' ' 
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extension), then "A." will be translated to "A.REL" by the 
"standard processor". Similarly, if the command 
COMPILE FILE. NEW 

is executed, the extension ".NEW", although meaningful to the 
user, does not specify a. language, so the "standard processor" 
Will be used. For these cases the user must be able to control 
the setting of the "standard processor". * 

The "standard processor" is FORTRAN IV at the begin- { 
ning of eadh command string. v 

The "standard processor" may be changed by the follow- 
ing compile-switches: 

MACRO change standard to MACRO 

. M same as MACRO ■ 

FORTRAN change standard to FORTRAN IV 

p same as FORTRAN 

REL change standard to use RELocatable' 

binary,- i.e., use existing .rel 
files, even though a newer source 
file may be present. (Useful 
primarily in LOAD, EXECUTE, DEBUG 
commands) . 


c 



TBe compilation (or assembly) occurs if the source 
file is at least as recent as the relocatable binary file. If 
the binary is newer than the source, there is not normally any 
need to perform the translation. 

There are cases, however, where such extra translatic 
may be desirable, as for instance, when one desires a listing c 
the assembly. To force such an assembly, the switch "COMPILE" 
is provided, again in both temporary and permanent form. For 
example : 


COMPILE /CREF / COMPILE A, B, C 
will create cross-reference listing files A.LST 
C.LST, even though current .REL files may exist 
binary files will also be recreated. 


The corresponding switch "NOCOMPILE 
to turn off the forced-compile made. Note th< 
from the /REL switch which turns off even the 
caused by a source file newer than the .REL f : 


The LOADER normally performs a library 
FORTRAN library. ■ Sometimes it is necessary to s 
as libraries. To do this, the compile-switches 
(its complement) "NOSEARCH" are provided. 

These switches may. be used as either " 
"temporary". - 


For example , suppose a s; 
SPCLIB. REL were kept on device SYS 
Then to compile and load a user pr< 



t> ll< I -yj 



special library, and then search the normal FORTRAN 
following command could be used: 


LOAD MAIN, SYS :SPCLIB/LIB 

At this point, it should be noted that the program SPCLIB is not 

r 

assembled simply because its source file is presumably not on 
device SYS. . The COMPILE process will compile any program named 
in the command string, if its source is present and not older 
than the .REL file, unless prevented by the' /REL switch. 


Loader maps are produced during the loading process by 
the compile-switch "MAP". When this switch is encountered, a 
loader map is requested from the Loader 
written with filename MAP. MAP 


The map will be 
in the user's disk area. 

This compile-switch is the one exceptipn to the 
"permanent compile-switch" rule, in that it' causes only one map 
to be output, even though it may appear as a permanent switch. 


Occasionally it is necessary to pass switches to the 
assembler or compiler. Recall that for each 'translation (assem- 
bly or compilation), a command string is sent to the translator 
containing three parts: the source files, a binary output file, 
and a listing file. If the user wishes to add switches to those 
files, he; must do so as follows: 


£ .'.EXECUTE,,, and DEBUG commands only, 

2 .- 25 . ■ 

'i'v' .v' ..rf U 


b 


fir 



-» - 


d) Enclose all the switches for each 
within one set of parentheses. 


(SSSS) Only source switches 

present 

(SSSS ,BBBB) Source and binary sw: 

are present 

(SSSS,BBBB,LLLL) Source, binary, and ] 
switches are present. 

Place each parenthesized string immediat 

.ename to which it refers. 


DEBUG TEST (N) 


COMPILE OUTPUT 


COMPILE/MACRO A = MTA0:(W,,Q) /L 

Rewind the magtape (W) , . comp 
first file, and suppress Q ( 
error indications on the 1 lis 
that when a binary switch is 
the delimiting comma must api 


COMPILE/MACRO A = MTAO: (,,Q)/L - \ 

Compile file at current position of the 
tape and suppress Q error indications 
on the .listing. Note that when the 
source and binary switches are not 
present, the delimiting comma must 
anopar. 


In unusually complex loading processes , it may be 
necessary to pass loader-switches to the LOADER to direct its 


LOAD,. EXECUTE 





operation. These are passed via the COMPILE, LOAD, EXECUTE , and 
debug commands . These switches must be passed to the loader' 
(not to the compiler or assembler) . This is accomplished by the 
% character. The % has the same meaning as that of the / in the 
Loader's command string. Also, like the /, it takes one letter 
(or a sequence of digits and one letter) following it. Therefore 
to set a program origin of 6000 for program^, the user types 
LOAD A,B, %60000C,D 

■ The most commonly used switches are: 

%S Load with symbols 
%nO Set program origin to n 


cause early search of FORTRAN library 
Prevent FORTRAN library search 


w. ouu ounsrruccs new commands for the CUSPS that were 
referenced. These new commands are written- as temporary files 
on the disk, as are all of the Monitor-level commands. COMPIL 
and the other CUSPS transfer control directly to one another 
without requiring additional typed-in commands from the user. 

' ^ Temporary filenames have the following form: 
nnnxxx . TMP 

where nnn is the user's job number in decimal, with leading 
zeros to make three digits and xxx specifies the use of the file 
In the filenames listed below, job number 1 will be assumed. 

2. 6.5.1 001SVC.TMP 


LOAD 


or DEBUG command which included 


: vV 




2. 6. 5. 2 001EDS.TMP 


This file contains the most recent EDIT, CREATE, 
or MAKE command which included an argument. it is used to 
remember that argument. See section 2.5 


001MAC.TMP 


to MACRO 


by COMPIL, and ready by MACRO 


command 


NAME! 


to cause MACRO to transfer control to the named, CUSP ("name 
may be F40, LOADER, etc.). 


2.6.5. 4 OOIFOR.TMP 


This file corresponds exactly to the one described in 
the preceding section, except that it is read by the FORTRAN IV 
compiler, F40. 


001PIP.TMP 


This file is written by COMPIL and read by PIP. it 
contains ordinary PIP commands to implement the DIRECTORY, LI 
TYPE , RENAME , and DELETE commands . 


001CRE ■ TMP 


^This file is written by COMPIL and read by CREF. I 
contains commands to CREF corresponding to each file which ha 
produced a CREF listing on the disk. 


COMPIL also ; reads this file, if it exists, each . time 
new CREF listing is generated, to prevent multiple requests 
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CUSP 


li 

Mss 


for the same, file, and to prevent discarding other 


requests which 


may not yet have been listed. 


2 . 6 . 5 . 7 ' 001EDT . TMP 


This file is written by COMPIL for each EDIT, CREATE, 
TECO, or MAKE command, and is read by either the LINED or TECO 


command 


For the commands MAKE or CREATE, ’it contains the 


Sfile.ext (alTMODe) 

For the commands TECO or EDIT, it contains the command 


Sfile.ext (RETURN) (LINEFEED 


2,7 RUN CONTROL COMMANDS 

By using a run control command, the user can load core 
image files from retrievable storage devices (i.e., disk, DECtape, 
magnetic tape).. These, files can be retrieved and controlled from 
the user's console. Files stored on disk and DECtape are addres- 

i Sable by name - Files on magnetic tape require the user, to pre-' 
position the tape to the beginning of the file. 



Taole 2-6 

Monitor Commands to Call, Load, 


Monitor Messages 


RUN dev 
file. ext 
[pro j, prog] 
core 


dev: MOT AVAILABLE 
Tlie device has been 
assigned to another job. 

NO SUCH DEVICE 
The device does not exist. 

nK QF CORE NEEDED [ 

There is insufficient 
free core to load the 
file. 


it cne program has two segments, both 
the low and high segments will be set 
U P* the high file has extension 
• SHR (as opposed to . HGH) , the high 
segment will be shared. A two- 
segment program may have a low file 
extension (.LOW). 


The logical or physi- 
cal name of the device 
containing the core 
image . 


TRANSMISSION ERROR 
A parity or device erro; 
occurred during loading. 


The name of the file 
containing the core 
image; if .ext is 
omitted, it is assume 
to be SHR + LOW, 

HGH + LOW, or SAV. 
See SAVE, SSAVE. 


[proj.prog] 


Project-programmer 
number; required only 
if core image file is 
located in a disk area 
other than the user's. 

Amount of core to be 
assigned if different 
from minimum core 
needed to load the 
the program or from 
the core argument of 
the SAVE command which 
saved the file. Since 
previous core is re- 
turned, MTA must have 
this argument because' 
there is no directory 
to tell how much core 
for low segment. 


Same as RUN SYS: file. ext core. 

R command is the usual way to rui 
CUSP that does not have a direct 
Monitor command to run it. 


GET dev 
file, ext 
[proj ,prog] 
core 


Same as RUN command 
Monitor types out 


and does not start execution, 




Command 


Explanation 


| START adr 


n of a program pre- 
tfith the GET command. 

The address at which 
execution is to begin 
if other than the 
location specified 
within the file 
(JOBSA) . if adr is 
not specified, the 
starting address comes 
from JOBSA. 


NO CORE ASSIGNED 
No core was allocated to 
the user when the GET 
command was given and no 
core argument was speci- 
fied in the GET. 


NO START ADR 
Starting address was 0 
because user failed. to 
specify a starting 
address in END statement 
of source program. 


[HALT (tC) 


.aces the console in. Monitor mode and 
•ansmits a HALT command to the Moni- 
•r Command Interpreter. Stops the 
ib and stores the program counter 
i the 30b data area (JOBPC) . 


CONT 


starts the program at the saved pro- 
gram counter address stored in JOBPC 
by a HALT command (tC) or a HALT 


CAN'T" CONTINUE 
The 30b was halted due 
to a Monitor-detected 
error and can't be 
continued. 


NO START ADR 
DDT starting address 
0 (JOBDDT) . 


REENTER 


NO START ADR 
REENTER starting address 
was 0 (JOBREN) . 


his program) 


Examines a core' location i 
area (high or low segment) 


OUT OF BOUNDS 
^The specified adr is, not 
in the user's core area, 
or the user does not have 
read privileges to file 
which initialized the 


If this argument is 
specified, the concr 
tents of, the location 
are typed out in half- 
word octal mode. Adr 
is required the first 
time the E or D 
command is used.: 

If adr. is not speci- 
fied, the contents of 
the location following 
the previously: speci- 
fied E adr or the 
/ location of the 
previous D adi; are • 
typed out. 




Deposits information in the user's 
core area (high or low segment) . 


OUT OF BOUNDS 
The specified adr is 
not in the user ' s core 
area, or high segment 
is write protected and 
user does not have 
write privileges to 
file which initialized 
the high segment. 


The octal value to be 
deposited in the left 
half of the location. 


The octal value to be 
deposited in the 
right half of the 
location. 


The address of the 
location into which 
the information is to 
be deposited. 

If adr is omitted, the 
data is deposited in 
the location following 
the last D adr or in 


Writes out a core image of the user's 
core area on the specified device. 
Saves any user program (reentrant, on< 
segment non-reentrant, or two segment 
non-reentrant) as one or two files. 
Later when the program is loaded by a 
GET, R, or RUN command, it will be 
non-reentrant. If DDT was loaded with 
the program, the entire core area is 
written; if not, the area starting 
from zero up through the program breafc 
(as specified by JOBFF) is written. 


n IK BLOCKS OF CORE 
NEEDED 

The user's current c£re 
allocation is less than 
the contents of JOBFF. 


DEVICE NOT AVAILABLE 
Device dev is assigi 
to another user. 


TRANSMISSION ERROR 


file. ext 


The name to be assign- 
ed to the core image 
file. If ext is 
omitted and the pro- 
gram has only one 
segment, the ext is 
assumed to be .SAV. 

If ext is omitted and 
the program has two 
segments, the high 
segment will have 
extension . HGH, and 
the, low segment will 
have extension .LOW. 


The output is completed. 


Amount of core in 
which the program is 


to be run. This value 
is stored in the job!s 
core area (JOBCOR) and 
is used by the RUN and 
GET commands . Speci- 
fied as number of IK 
blocks. V 













it core is omitted, 
only the number of 
blocks required by 
the core image area 
(as explained above) 
is assumed. 


Same as SAVE except that the high 
segment will be sharable when it is ' 
loaded with the GET command. To \ 
indicate this sharability, the high 
segment is written with extension. 
.SHR instead of .HGH. A subsequent 
GET will cause the high segment to be 
sharable. Because an error message 
is not given if the program does not 
have a high segment, a user can use 
this command to save CUSP's without 
having to know which are sharable. 


*Refer to footnote 


2 • 7 ■ * Additional Information on SAVE and SSAVE 


Low segment files will be . zero compressed on all 
devices (DTA,MTA,DSK) , but high segment files will, not since the 
high segment may be shared at the time of the command. Saved 
files are ordinary binary, files and can be copies using the /B 
switch in PIP. _ 

In order to save file space, only the high segment up 
through the highest location (relative to high segment origin) ~ 
loaded, as specified in the LH of JOBHRL, will be written by the 
SAVE command. If LH is .zero (high segment created by CORE or 
REMAP UUO) or Dpi is present, the entire high segment will be 
written. 

, '>• • 
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ssave dev 
file. ext 
core 



Si 




It is possible’ for most programs to be written so that 
only the high segment contains non-zero data. This will also 
save file space and I/O time with the GET command . SAVE will 
write the high segment (.HGH) only. The LOADER will indicate to 
the SAVE, command that no data was loaded above the Job Data area 
in the low segment by setting the LH of JOBCOR to the highest 
location loaded in the low segment with non-zero data. 

There are a number of locations in the Job Data area 
which need to be initialized on a GET, even though there is no 
other data in the low segment. The SAVE command copies these 
locations into the first .10 g locations of the high segment, pro- 
vided it is not sharable. These 10 locations are referred to as 
the Vestigial Job Data area. Therefore, the LOADER will load 
high segment programs starting at location 400010. 

To prevent user confusion, SAVE and SSAVE delete a 


previous file with the extension .SHR or 
deletes a file with the extension 


HGH. Therefore, SAVE 
SHR and SSAVE deletes a file 
with the extension .HGH. Both commands also delete a file with 
the extension .LOW, if the high segment was the only segment 
written. 


The regular access rights of the saved file indicate 
- 

whether a user can do a GET, R, or RUN command. These commands 
will assume that the user wants to execute (but not modify) the 
high segment independent of the access rights of the file used 

V 

to initialize the segment. The Monitor will always enable the 

hardware user-mode write protect to prevent the user’ program ’ ' 

from storing into the segment inadvertently. 

' 

To debug a reentrant CUSP which is in the system ■ 

■ . ■ V’j 

directory, the user should make a private, non-sharable copy, • ft 

rather than modifying the shared version and possibly causing 

Z-34 A 

. . .■ ... . :! 




343 

harm to other users. To make a private, non-sharable copy, the 
following commands are used. 

a) GET SYS CUSP 

b) SAVE dev CUSP Writes a file in the user 

directory as non-sharable. 

The high segment in the 
user's addressing space 
remains sharable. 

o) GET dev CUSP Overlays th'e sharable 

program with the non- 
sharable one. from the 
^ * user's directory. Now 

the user can make patches 
while other users share 
/ the version in the system 

directory. 

The Monitor will keep the shared and the non-shared versions . 
separate from each other . A sharable program may be superseded 
into the directory by the SSAVE command. The Monitor will clear 
the high segment in its table of storable segments in use but 
will not remove the segment from the addressing space of users 
currently using it. Only the users doing a GET, R, or RUN com- 
mand or a RUN or GETSEG UUO will have the new sharable version. 


When the SAVE or SSAVE command is used to save a 
sharable program with only a high file, the Monitor will not 
modify the Vestigial Job Data area unless the user has write 
privileges to the file which initialized the shared segment. 
This prohibits unauthorized users from modifying the first 10 
locations of a shared segment. This restriction does not exist 
'if a, low file is also written, since the GET command reads the 
low file after the high file. The real Job Data area locations 
are set from the low file. 


* 




BACKGROUND JOB CONTROL 'COMMANDS 


A job is a background, or detached 
under control of a user console 


job if it is not 
Any console can initiate any 
number of background jobs. I/O to the console while a job is 
running in a background mode causes the job to stop until a 
console is attached. 

Table 2-7 

Monitor Commands to Control Background Jobs 


Command 


Explanation 


Monitor Messages 


Monitor responds by typing the job 
number to which the user's console 
attached . 


10/40 System - If the console is not 
attached to a job. Monitor assigns a 
job number and types the job number 
and a line identifying the Monitor 
version. 


CSTART 

CCONT 


Identical to the START and CONT com- 
mands, respectively, except that the 
console is left in the Monitor mode. 
To Use: 


Begin the program with the con- 
sole in user mode. 


Type control information to the 
program, then type +C to halt job 
with console in Monitor mode. 

Type CCONT to allow job to con- 
tinue running and leave console 
in Monitor mode. 


Further Monitor commands can now 
be entered from the console. 


Caution 


These commands should not 
be used when the user pro- 
gram (which is continuing 
to run) is also requesting 
input from the console. 


Disconnects the console from the 
user's job without affecting the 
status of the job. The user console 
is now free to control another job, 
either by initiating a new job or 
attaching to a currently running . 
background job. 
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Command 


Explanation 


Monitor Messages 


ATTACH job 


a background 


If an error message 
occurs, the console re- 
mains attached to its 
current job. 

TTYn ALREADY ATTACHED . 
Job number typed Is 
erroneous and is attach- 
ed to another console,, 
or another user is 
attached to the job. 

NOT A JOB \ 

The job number is not ' 
assigned to any cur- I 
rently running job. f 

tAN'T ATTACH TO JOB 
The project-programmer 
number entered is not 
that of the originator 
of the desired job. 


The job number of the 
job to which the con- 
sole is- to be attach- 
ed. 


The project-programme] 
number of the orig- 
inator of the desired 
job. May be omitted 
if same as job to 
which console is cur- 
rently attached. The 
operator (device OPR) 
may always attach to 
a job even though 
another console is 
attached, provided he 
specifies the proper 
(pro j, prog] . 


Refer to footnote in Table 2-1 


JOB TERMINATION COMMANDS 


When a user leaves the system, all facilities allocated 
to his jobs must be returned to the Monitor facility pool so that 
they are available to other users. 

Table 2-8 

Monitor Command to Terminate Jobs 


KJOB 

K , 

In Multiprogramming Systems: 

m 



Stops all allocated I/O devices and returns 
them to the Monitor pool. 

A 

- - - 


Returns all allocated core to the Monitor 




pool. 

' Returns the job number to the pool. 

Leaves the console in the Monitor mode.' 




. Performs an automatic TIME command. 

In Swapping Systems: 

All of the above procedures. In addition, if 




user has any files, responds with: 


. 


CONFIRM: 





TIME job 









Command 


lonitor Messa< 


2- 11 SYSTEM ADMINISTRATION COMMANDS ■ 

The SYSTAT command permits a user to learn how heavily 
the system is loaded and the status of devices in the sharable 
device pool. The other commands in this section are restricted 
to system, administrators only. 


jV 

Explanation 

level, and job scheduling times are 
charged to the user who was running when the 
interrupt or rescheduling occurred. 

^ ob The job number of the job 

whose timing is desired. 

If job is omitted, the job to 
which the console is attached 
is assumed. In this case. 
Monitor types out the incre- 
mental running time (running 
time since last TIME command) 
as well as the total running 
time since the job was ^ 
initialized. 

V If job a 0, an approximation 

of the time spent core shuf- 
fling (SHFL) is printed, 
followed by the amount of time 
spent clearing core (ZCOR) , 
the running time of* the null 
job (NULL) t the time during 
which one or more jobs wanted 
to run but were swapped out or 
in the process of being swap- 
• t ped out (LOST) , and the total 
time system has been up (UP) . 


*Refer to footnote in Table 2-1 
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Table 2-10 



Explanation 


SCHEDULE 


Changes the scheduled use 01 
pending on n. This command 
the operator's console, n : 
STATES word in COMMON: 


: the system, de- 
is legal only from 
s stored in RH of 


regular time sharing. 

no further LOGINS allowed. 

no further LOGINS from remote TTY'i 

omitted, the current value of n is 


SYSTAT 


Types out status of the system: syst 
time of day, date, uptime, percent nu 
Status of each job: job number, proi 
programmer number (***♦ if detached) 
number, program name being run, size', 
segment, state (RN » runable, TT = TT' 
wait, C = Monitor command mode) and : 
Status of high segments being used: 1 
directory name, size, number of users 
or on disk. Status of each assigned < 
name, job number, how assigned (AS = } 
command, INIT = INIT UUO) . 


ASSIGN 
SYS: dev 


DETACH dev 


To assign the device ' 
making it unavailable, 
logged in under [1,1], 


'dev" to JOB 0, thus 
The user must be 


ATTACH dev 


To return a detached device 
pool of available devices, 
logged in under [1,1]. 


to the Monitor 
The user must be 


Monitor Commands for System Administration 


Command 



Meaning 


The DECtape directory is not in 
proper format or had a parity error 
when read . Many times this error 
occurs when ah attempt is made to 
use a virgin tape. 


Device dev is temporarily in an •. 
inoperable state, such as LPT off- 
line. The user should correct the 
obvious condition and then type a 
CONT command . 


The Monitor command decoder has 
encountered an incorrect character, 
such as a letter in a numeric argu- 
ment. The incorrect character 
appears immediately before the ? . 
Example: 

User types in: CORE ABC 
Monitor responds : CORE A ? J 


Monitor has checked a user address 
and has found it to be too large 
( >C ( JOBREL) ) or too small (<JOBPFI) 
Some user addresses can be the 
user's accumulators while others 
cannot. ♦ 


One of the following addresses may 
be wrong: ■ 
buffer 

buffer header 
dump mode command list' 
data specified by dump mode 
command list 

insufficient core available for 
setting up 

Monitor-generated buffers. 


2.12 MONITOR DIAGNOSTIC MESSAGES 

Once a user program has been started, a number of error 
conditions may arise which cause the job to revert to monitor 
mode. The error messages typed, and the meanings for each are 
summarized in the following table. 


Table 2-11 

Time— Sharing Monitor Diagnostic Messages 


The typein is typed back 
followed by ? J 


ADDRESS CHECK FOR DEVICE 
dev AT USER adr 


BAD DIRECTORY FOR DEVICE 
DTAn ; • 

UUO AT USER adr — 




Table 2-11 (cont) 
Time-Sharing Monitor Diagnost 


Meaning 


ERROR in JOB n 


a fatal error has oo 
user's job (or in Mo: 
servicing the job) . 
is normally followed 
description of the e: 

The user program has 
halt instruction at ] 
Typing CONT will rest 

at the effective addr 
halt. 


HALT AT USER adr 


HUNG DEVICE dev 
UUO AT USER adr 


ILLEGAL DATA MODE FOR 
DEVICE dev AT USER adr 


The data mode 
device in the 
illegal . 


ILL INST 


operation code has bee] 
l in the user ' s program? 

memory reference has / 
>y the user program at 1 


INCORRECT RETRIEVAL 
INFORMATION : 

UUO AT USER adr 


No OPEN or INIT 
the channel. 


LOOKUP AND ENTER 
DIFFERENT NAMES: 
UUO AT USER adr 


An- attempt has been made 
and write a file on the , 
However, the LOOKUP and ] 
have specified different 
the same user channel. 1 
sage does not indicate a 
error . 


INPUT DEVICE dev 
CANNOT DO OUTPUT; 
UUO AT USER adr 


I/O TO UNASSIGNED CHANNEL 
AT USER adr 



‘-^rtfrflffcnn miinit 





Meaning 


MASS STORAGE DEVICE 
UUO AT USER adr 


FULL 


Monitor has encountered an error 
while reading *pr writing a critical 
block in the disk file structure 
(e.g., the MFD or the SAT table). 

If this condition persists, the 
disk must be reloaded' using Fail- 
safe after, the standard location 
for the MFD and SAT table has been 
changed using the Monitor once- 
only dialogue. 

The Monitor has run out of free 
core for assigning disk data 
blocks and Monitor buffers. If 


this type-out occurs, the user 
should report it on a Software 


Trouble Report. .. ■ 

The program file requested ca: 
be found on the systems devio 
on the specified. device) . 

An illegal INPUT UUO has been 


A consistent checksum error 
been encountered when check 
locations JOBDAC through jo: 
of the Job Data area during 
swapping . 
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Table 2-11 (Cont) 


non-recoverable disc read 

ERROR; 

UUO AT USER adr 

NON-RECOVERABLE DISC WRITE 
ERROR; 

UUO AT USER adr 


NOT ENOUGH FREE CORE IN 
MONITOR: 

UUO AT USER adr 


NOT FOUND 


OUTPUT DEVICE dev CANNOT 
DO INPUT; 

UUO AT USER adr 

PC EXCEEDS MEMORY BOUND 
AT USER adr , 


SWAP READ ERROR 


Time-Sharing Monitor Diagnostic Messages 


glgP 


5.1.1 


Data Modes 
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Full-Duplex Software a (ASCII) and AL (ASCIT r. 
The input handling of all control characters 
.assed to program except as noted below) . 


NULL 

+A 

+B 


ignored on input, suppress* 
Echoes as tA. Passed to pi 
Complements switch control] 
not passed to program. Use 
copy dataphones and TWX's. 
The Teletype mode is switch 
mode the next time input is 
the program. Two successiv 
the. mode to be switched to 
immed ia tely . 

004 passed to program. Not 
typing in a "Control D" (EO 
cause a full duplex datapho 
No special action. 
Complements switch controll 
tion of lower case letters 
Used when lower case input 
programs. Not sent to prog 
gram can sense the state of 
by the TTCALL UUO. 

007 passed to program, and 
character. 

Acts as a RUBOUT, unless eil 
or full character set mode ■ 
the +F switch is on. In the 

010 is sent to the program. 

011 passed to program. Echc 
if Teletype is a model 33 (c 
■f-P switch) . Spaces are not 
program. 

Is a break character. No ot 
action. 

013 passed to program. Echo 
linefeeds, if a model 33 I 
character. Linefeeds are no 
program. 

014 passed to program. Echo 
feeds on a 33. Is a break c 
Linefeeds are not passed to 
If Teletype is in paper-tape 
is simply passed to program, 
supplies a linefeed, echo, an. 
to program as a CR and LF, a 
character (due to LF) . 

No special action 
Suppresses output. until an II 
INIT, or OPEN UUO occurs. N( 
program. Typed as +0 follows 
return-linefeed. 


004 +D (EOT) 


005 tE (WRU) 

006 tF 


007 +G (Bell) 


010 +H (Back- 
space) 


011 +1 (TAB) 


iJ (Line- 
feed) 

+K (Vertical 
Tab) 


014 +L (Form) 


.-IM (Carriage 
Return) 




021 fQ (XON) 

022 tR (TAPE) 

023 +S (XOFF) 

024 tT *(NO TAPE) 

025 +U 


026 +V 

027 tW 

030 +X 

031 +Y 


033 +[ (ESC) 


034 +\ 

035 +] 

036 + + 

037 

040-137 

140-174 


175 and 176 


Does not appear in the input buffer. Some 
Teletype units (usually Models 35 and 37) 
have horizontal tab,, vertical tab, and 
form feed mechanisms while other units 
(usually Model 33s) do not. If the user 
finds that his particular Teletype unit 
- does not have these mechanisms, he should 
type +P. Otherwise, tabs will not be 
printed at all or spaces will be substi- 
tuted for a tab depending upon the 
Monitor's assumption. 

Starts paper— tape— mode , as described above. 
Passed to program.’! 

No special action . \ 

Ends paper-tape mode, as described above. > 
023 is passed to program. 

No special action. 

Deletes input line back to last break char- 
acter. Typed back as tU followed by 
carriage return-linefeed. 

No special action. 

No special action. 

No special action. 

No special action. ? 

Acts as end-of-file on Teletype input. 
Echoes as +Z followed by carriage return- 
linefeed. Is a break character. Appears 
in buffer as 032. 

This is the ASCII altmode these days, but 
is translated to 175 before being passed 
to the program, unless in full character 
set mode (bit 29 in INIT) . 175 is the 1963 

altmode. Echoes as a dollar sign. Always, 
is a break character. 

No special action. 

No special action. 

No special action 
No special action. 

Printing characters, no special action. 
"Lower case" ASCII. Translated to upper 
case, unless /F switch is set. Echoes as 
upper case if translated to upper case. 

Old versions of altmode. See description 
of "ESC" (033). 

RUBOUT or DELETE: 

A) - Completely ignored if in papertape mode 

(XON) 

B) Is a break character, passed to program, 

if either DDTmode or f ullcharacter-set 
mode is true. ’ * 

C) Otherwise (ordinary case) causes a 
character to be deleted for each rubout 
typed. All the characters deleted are 
echoed between a single pair of back- 
slashes. If no characters remain to 

be deleted, echoes as a carriage return- 
■' linefeed. 






Initialization 


R EDITOR 


Commands 


Command 


Function 


Sn TAJ 

Sn, filename, ext tA $ 


Select DECtape n and zero the directory. 

^elect DECtape n, zero the directory, and 
create a file called filename. ext. 


SOURCE PROGRAM .PREPARATION 

i 

DECTAPE EDITOR (EDITOR) \ 

Editor creates, adds to, or deletes from sequentially numbered source files recorded in lines of ASCII 
characters on a DECtape. Editor edits the source file; (the input and output files are the same). Fresh 
source files have editing space in each physical DECtape block. If the user has more edits for a block 
than will fit in it, an extra block in the DECtape is used and appropriately linked to the preceding and 
following logical blocks of the file. Editor provides a simple method of creaTing or modifying Macro or 
FORTRAN IV source programs. 

Requirements 


Minimum Core: 
Additional Core: 
Equipment: 


One DECtape unit for the reel containing the file(s) to be 
modified 


Loads the DECtape Editor program. 
Editor is ready to receive a command. 


Initialize a File For Processing 







Commond 


$n, filename .ext^ 


Select DECtape n and locate filename. ext for 
processing . 

Select DECtape n and add a new file called 
filename .ext. 


Sn, filename. ext $ 


NOTE 


All the above commands place Editor i 
i .e. , the next typein is assumed to be 
given below. 


Insert a Line 


Innnnn 


Insert the following typed line at line number 
nnnnn of the currently open file; nnnnn can be 
specified as a line sequence number or as a 
point (.). A point refers to the last line typed. 
If the line number already exists in the file, 
the line is replaced. 


Insert Multiple Lines 


Innnnn, increment 


Insert the following typed lines, beginning at 
line number nnnnn of the currently open file; 
nnnnn can be specified as a line sequence 
number or as a point (.) . Each time a line is 
entered, nnnnn is. increased by the specified 
increment, and the result becomes the line 
number for the next insertion. Type $ after 
last line insertion. ~ 


Delete a Line 


Dnnnnn 


Delete line number. 


nnnnn from the currently- 
open file; nnnnn can be specified as a line 
sequence number or as a point (.) . 








Delete a Series of Lines 


Close the Current File 


; R EDITOR ) 


Select DECtape I and create a- new file on 
DECtape 1 called VECTOR. 

Begin inserting at line sequence number 20; 
and increment this number by 20 each time 
a line is inserted. Switch to Text Mode. 


Closes the currently open file. Another file 
can be opened on the same or a different 
DECtape via an Sn command, or a return 
can be made to Monitor to terminate Editor. 


(End of file) 


*5 1 j VECTOR $ 


i Command 


Delete lines mmmmm through nnnnn from the 
currently open file. 


Print lines mmmmm through nnnnn of the 
currently open file. 


Pnnnnn^ 

nnnnn aaa . . .aaa ^ 


Print a Line 


Print line number nnnnn of the currently open ( 
file; nnnnn can be specified as a line sequence' 
number or as a point (.) . 


Pmmmmm,nnnnn j 
mmmmm aaa . . .aaa } 


Function 


Dmmmmm / nnnnn^ 







00020 DEFINE VMAG CA,B)} 
00040 <MOVE 0 , A } 

00060 FMP 0 } 

00080 MOVE 1 ,A + 1} 

00100 FMP 1,1} 

00120 FAD 1} 

00140 MOVE 1 ,A+2} 

00160 FMP 1,1} 

00180 FAD 1} 

00200 JSR FSQRT} 

00220 MOVEM B } 

002 40 $ S } 


Typing $ terminates insertions and returns Editor 
to command mode. 

Change line number 00020. 


00020 DEFINE VMAG CA,B,C)} 
* I LR * } 


HR* indicates that the indexing increment has 
resulted in the next line number being equal to 
the line number of an already existing line (000- 
Note that the indexing increment remains as 20 
until explicitly changed. 

Insert a line between lines 00080 and 00100. 


00090 MOVE 1,0} 


*ILS* indicates that the indexing increment has 
resulted in an existing line (00100) being skippe 
since the next line addressed would be 001 10. 
Delete line 00180. 

Print lines 00020 through 00220. 


(50020 DEFINE VMAG <A,B,C>} 
00040 <M0VE 0 , A } 

00060 FMP 0} 

00080 MOVE 1,A + 1} 

00090 MOVE 1,0} 

00100 FMP 1,1} 

00120 FAD 1 } 

001.40 MOVE 1 ,A+2} 

001 60 FMP 1,1-} 

00200 JSR FSQRT} 

00220 MOVEM B} 


Close the currently open file 
Return to the Monitor. '' 
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Commands 


Command 


Function 


Dnnnnn J 


NOTE 


Meaning 


CCL error. Ei 
command file. 


LINED responds with an asterisk to indicate 
it is ready to accept a command string . 


LINED commands are very similar to those of Editor; consequently , only a brief summary is given here. 


S filename .ext ) 

S filename .ext $ 

Innnnn ) 

Innnnn increment ^ 


Dmmmmm >nnnnn ) 
Pnnnnn ) 

Pmmmmm,nnnnnJ 


Select an existing file for editing. 

Select (create) a new file for editing . . 

Insert a line at line number nnnnn. 

Insert multiple lines, starting at line number 
nnnnn and incrementing the line number each time. 

Delete the line at line number nnnnn . 

Delete lines mmmmm through nnnnn. 

Print line number nnnnn on the Teletype. 

Print lines mmmmm through nnnnn on the Teletype. 

End (close) the current file. 

If in Insertion Mode, ignore current text line 
• and return to LINED command level . If in 
Command Mode, print the next line. 


Files are written with standard protection (055): All blocks 
are assumed to have integral number of lines. Use the /A 
switch (line blocking) with PIP to put each file on disk. 

Diagnostic Messages 

The diagnostic messages for LINED are similar to those for Editor. The diagnostic message ?DEC* is 
not included, and the following message is added: 
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LINE EDITOR FOR DISK (LINED) 

LINED is similar to DECtape Editor, but operates on disk files instead of DECtape files. LINED is 
called in by typing , 


.R LINED 




Monitor Commands 


To coll in UNED and open a now file for creation: 


Monitor Command 


Equivalent CUSP Commands 

.R lined; 

•iS filename. ext $ 


CREATE filename 


To call in LINED and open an existing file for editing: 


Monitor Command 


Equivalent CUSP Command 


.EDIT filename. 


4 r lined; 

filename .ext 



W7 




i,. 


*PDP-IO TECO is based op PDP-1 TECO, developed of MU by Daniel Murphy , and PDP-6 TECO 
developed at MIT’s project MAC by Stewart Nelson and Richard Greenblatt. 


TECO automatically requests more core to expand its 
buffer under any of the following conditions: 


TEXT EDITOR AND CORRECTOR (TECO)* 

TECO edits files recorded in ASCII characters on any standard device. It can perform simple editing 
functions as well as highly sophisticated search, match, and substitute operations, and operate upon 
arbitrary length character strings under control of commands which are themselves character strings 
(and contains the mechanisms necessary to exploit this recursiveness). 


NOTE 


Requirements 

Minimum Core : 

* 

Additional Core: 


Equipment 


One input device and one output device . 


Takes advantage of any additional core .available. Each IK 
additional core augments the basic 6,200+ - character buffer 
by 5K additional characters. 




a . An insert by way of the "I" command or "X" 
(Q Register) will overflow the present memory 
boundaries . 

b . The command acceptance routine needs more 

core . * 

c. The total number of characters in the Data 
Buffer falls below 3000/ and an input command 
from a peripheral device (other than the user 
console) is executed. Thus, TECO maintains a 
Data Buffer of at least 3000 characters . 


If TECO is successful at obtaining more core, the follow- 
ing message will be typed: 

*10000 <IJS>$$ 

nk Core, where n is 
new core size of job 


[5K CORE] 


If TECO is unsuccessful at obtaining the core request 
the following message is typed: 

sto'rage capacity exceeded 


Initialization 


Loads the Text Editor and Corrector program 
TECO is ready to accept a command. 


Basic Commands 


NOTE 


When typing command strings to TECO, the following 
points should be noted. \ 

t 

$ One $ is used to terminate the text within 

a command string, where applicable; two 
successive $s terminate the entire command 
string sequence and generate a RETURN, 

LINE-FEED. ! 

^R UBOU T) The RUBOUT key can be used to erase the 
preceding typed-in character^) of a com- 
mand string . Each character erased is 
echoed b ack on the teletype (e.g., ABD 
CgjBOUE> DC...). Successive RUBOUTs 
can be used to erase more than one character , 


i 




N.B. To erase a carriage return (which generates 
RETURN, LINE-FEED), two RUBOUT's are required, 
one RUBOUT to erase the LINE-FEED and one to 
erase the RETURN . 

Two successive tGs ( (BELL) s) cqn be used to wipe 
out the entire command string currently being typed.' 


TECO commands in the form tx (where x is any character) 
can be entered by either holding down the CTRL key 
while striking the x key or typing up-arrow (shift N) 
followed by the x character. These alternatives are 
not true where tx is a character within a text string 
(such as in a Search argument); in this case, the CTRL 
key must be used . 

A carriage return, line feed, ( i ) is ignored in a TECO 
command string as long as it does not appear within a 
particular command, such as Insert. Examples of this are 
given on the following pages. 


Select The Input Device 


Command 


Function 


ERdev:filename. ext [proj, prog] Edit Read. Selects the input device and file 

$ (if specified). 


(DECtape) - 
(paper tape reader) 
(disk) 

(magnetic tape) 

(card reader) 

(DSK: or DTAn: only) 


DTAn: 

PTRi 

DSK: 

MTAn: 

CDR: 


filename .ext 


NOTE 


Device TTY: cannot be used 
here . See I (Insert) command . 

Specified only if file is located in 
other than user's area . 


Edit Backup. Selectman input and file to be 
edited (the input device, which will also be 
the output device for the edited file, must be 
the disk*). EB is intended to be used to keep 
a backup of a file during a debugging session , 
without the user having to invent a new name 
'for each version of the file. 


EBdev:fi lename . ext $• 


*lf dev: is not specified, DSKi is assurtied 






Command 


Function 


For example, the command string sequence 
EBPROG1 .MAC $ 


editing 


initially given a temporary name of TECOnn .TMP,n ' 
where nn is the user's job number in octal; in- 
corporating the job number in the filename solves 
the problem of identifying temporary files belong-.;' *1 
ing to multiple 100,100 users 

c. Performing a number of RENAMES following '-.fM 
the EF command so that the input file becomes •’.>$ 
PROG1 .BAK, any previous PROG1 .BAK file is 
deleted, and the new output file becomes 


Select The Output Device 


EWdev.fi lename .ext [proj,prog] Edit Write. Selects the output device and file 

$ (if specified). 

EZdev.fi lename .ext [proj,prog] Edit Zero. Selects the output device and file 
^ , Of specified), and rewinds the tape (if magnetic 

tape) or zeros the directory (if DECtape). 


the directory (if DECtape) 


(disk) 

(mognetic tape) 
(paper tape punch) 
(line printer) 


1 1PP 
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Function 


Terminate Output; Close File 


Magnetic Tape Positioning 


NOTE 


Throughout TECO^all numbers in 
command strings are interpreted as 
decimal . r : - 




Edit Magtape. Rewind the currently selected 
input magnetic tape. 

Depending upon the value of n, perform one 
of the following operations on the currently 
selected input magnetic tape. 

n i Operation 

1 Rewind tape to load point. 

3 Write end of file. 

6 Ship one record. 

7 Backspace one record. 

8 Skip to logical end of tape . 

,9 Rewind and unload tape. 

1 1 Erase 3 in. of tape . 

14 Advance tape one file. 

15 Backspace tape one file. 


End File. Terminate output on the current 
output file and close the file without selecting 
a new output file . 


Command 


Specified only if file is located 
in other than user's area. 


Exit. The EX command finishes the current edit 
operation by writing out all remaining pages off 
a file, performing an EF (End of File) command, 
and then exiting to the Monitor. Thus, EX is 
equivalent to the command string 

1000000PEF (bel£) 

Exit and Go. The EG command executes an 
EX command followed by the last Monitor 
command (COMPILE, LOAD, EXECUTE, or 
DEBUG) typed by the user. (See Chapter 9.) 


filename .ext (DSK: or DTAn: only) 
[proj,prog] (DSK: only) 




Function 


Read from current input device into buffer 


a. A FORM character is read (i.e., a page has 
been input), or 

b. The buffer is more than 2/3 full and one of the/ 
following is encountered 

(1) Line Feed . 

■ (2) Form Feed 

c. or a point 128 characters from the end of the 'J? 
buffer is reached . 


is destroyed. The pointer is positionec 
before the first character in the buffer 
tive buffer size for 5K TECO: 

Total buffer capacity 
2/3 buffer capacity : 

1 line-printer page = 
line) 

(60 lines) 7,800 characters (130 char ./line) fljj 

Append. Read from the current input device and/ 
append the incoming data to information already $ 
residing in the buffer . Terminate reading on the ^ 
same conditions as in Y. 


= approx . 1 1 ,200 characters^ 
= approx. 7,4^0 characters / | 
7,200 characters (120 char ijj 


NOTE 

No previous data is destroyed . • The 
pointer is not moved. 


Output Commands | 


Punch, Wait . Output the entire buffer to the >;‘$j 
selected output device, with a FORM character ,/• 
appended as the last character. Do not alter the-- 
contents of the buffer or move the pointer. ' 
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Editing Commands 


Lines. +n - Move the pointer to the right, stop- 
ping after it has passed over n UNE-FEED 
characters . 

-n - Move the pointer to the left, stopping after it 
has passed over n +1 LINE-FEED characters, then 
move to the right of the last LINE-FEED character 
passed over . 

If n is omitted, assume TL. 


Delete Text 


Delete. Delete n characters. ‘ 

+n - Delete n characters just to the right of the 
pointer. , 

-n - Delete n characters just to the left of the 
pointer. 

If n is omitted, I is assumed. 


Function 


Move The Pointer 


Perform the P command n times. 


Output the m+1 through the nth character from the 
buffer to the’ current output file. Do not append a 
FORM character at the end. Do not alter the 
contents of the buffer or move the pointer. « 


Jump . Move pointer to the tight of the nth buffer 
character and give the pointer symbol (.) the value 
of n. If n is omitted, set pointer in front of the first 
buffer character (same as OJ) . 


Continue . Set the pointer to the right of the nth 
character beyond the pointer's present position 
(equal to .-tnJ). If n is omitted, 1 is assumed. 


Reverse . Set the pointer to the left of the nth 
character prior to the pointer's present position 
(equal to .-n). If n is omitted, 1 is assumed . 


Equivalent to a PW command. followed by a Y 
command (i .e., output the current contents of the 
buffer followed by a FORM character, and then 
read in more data from the input device). 


Command 





Command 


Function 


Kill . +n - Move the pointer to the right, 
stopping after it has passed over n LINE-FEED 
characters. Delete all characters the pointer 
passes over . 

-n - Move the pointer to the left, stopping 
after it has passed over n+1 LINE-FEED • 
characters, then move it to the right of 
the last LINE-FEED character passed over. 
Delete all characters between this point 
and the pointer's previous position. 

If n is omitted, 1 is assumed. 

Delete the m+1 through the nth characters 
of the buffer. Set the pointer where the 
deletion occurred, i 


Insert Text 


Insert. Insert the text following the "I" up 
to, but not including, the $ character, begin- 
ning at the current pointer position. Move 
the pointer to the right of the inserted material 


Insert at the pointer location a character with 
an ASCII code of n (n must be a decimal value) 
Move the pointer to the right of the inserted 
character. 

Insert at the current pointer location the ASCII 
text representation of the decimal value of the 
expression n . Move the pointer to the right of 
the inserted text . 

■ vs 

Insert at the current pointer location a ( -H ) "... 
character and the following text up to, but not* 
including, the $ character. Move the-pointer t 
the right of the inserted text. 

' '• 

Insert at the current pointer location the text 
which follows. The text is delimited by a 
character, /, which can be any character not . 
appearing in the text. 


NOTE 


T commands do not move the pointer 


'iiiii i ~-f iirWfii raiisi Min iTtfiii'' 
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Function 


Read a page into the buffer from the current 
input file, destroying the previous contents 
of the buffer . 

Read a poge into the buffer, appending the 
data to the end of the information currently 
In the buffer. 


Command 


Stand-Alone Examples (Elementary) 


Type. Type out the string of characters beginning 
at the current pointer position and terminating 
after the nth LINE-FEED character is encountered. 

+n - Typeout n lines to the right of the current 
pointer position. 

-n - Typeout n li/ies to the left of the current 
painter position . 

If n is omitted, tKe value is assumed to be 1 . 

Type out the m + 1 through the nth characters of 
the buffer . 


Open the input file called SOURCE. MAC 
located on DTA5. 

Open the input file called SRCE.MAC 
located in area 12,24 on the disk . 

Open an input file on the paper tape reader. 


I Op en an Output File| 

EVJDTA3 : ED IT ED • MAC £ Open an output file on DTA3 and call it 

EDITED. MAC. 


EZDTA1 :DEBUG*MAC £ 


Zero the directory on DTA1 , open an output 
file on it, and'call the file DEBUG .MAC. 


ERDTA5: SOURCE. MAC l 

ERDSK :SRCE • MAC C 1 & >24] 

ERPTR : 1 
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Command 


Function 


J19C3D 


NOTE 


Output Data 


Output the entire buffer, followed by a FORM 
character . 

Execute the WRITE and READ cycle six times. 

Write out the 13th through the 50th characters ^ 
of the buffer. 

■ ' 


I Pointer Positioning] 


Read in a page of information and position the 
pointer after the 18th character of the buffer. 

Then, move the pointer left to between char- 
acters 13 and 14. 


[Delete Text I 


Move the pointer to the right of the 19th 
character in the buffer and then delete the 
next three characters to the right (characters 
20, 21, and 22). 

r ■ 

Delete the 19 + 1 (20th) through the 22nd 
characters of the buffer . 


Insert Text 


J2UTAG: MOVE 1 , AMT 

s 


; 


H ERROR IN JOB $ 


Move the pointer to a position following the 
second line of the buffer; insert the text .TAG: 
MOVE 1 , AMT between the second and third 
tines of the buffer. 

Insert the digits 69 in ASCII at the current 
pointer position (same as 169 or $ orS4I57I), 


Unless a \key is present, \ is typed with a £ S 
shift i. 

Insert a tab followed by the text ERROR IN 
JOB at the current pointer position. t.| 








Command 


Function 


Insert the text ERDSK:PROG $ at the current 
pointer position. 


(s l # ER DSK : PR 0G1 # ; 


NOTE 


The use of delimiters is the only method 
for inserting a $ in the text. 


Type out- the first three lines of the buffer. 

Type out the 25 + 1 (26th) through the 100th 
character of the buffer 1 


Open the file called SCFILE.MAC on DTA1 
for input . 

Open an output file on DTA2 and call it 
EDFILE .MAC. 

Read a buffer of information from the input 
file and type the first 20 characters of the - 
buffer. 

Move the pointer to the right, stopping when 
three LINE-FEED characters have been en- 
countered; type the text of the fourth line 
in the buffer. . 

Insert the text THIS IS A SAMPLE INSERT ) 
between the third and fourth lines of the 
buffer, and position the pointer after the 
inserted material. 

Write out the current buffer to the output 
device; read in and write out the next nine 
pages of data; read in the 1 1th page of data 
and position the pointer- at the beginning of 
the buffer; type out the first fine of the 
buffer. 

Delete this line from the file; position 
th$ pointer at the beginning of the (now) 
first line in the buffer. 


ERDTA ItSCFILE.MACIS; 


* EWDTA2 : EDFILE. MAOISM 


♦ YB.P0TU } 


aaaaa 


3LTU> 


bbbbb 


.bbbbb ) 


INSERT 2 


+_l 


Command 


Function 






Kill the job, deassign all devices, release 
core . 


Advanced Commands 


Search Commands 


Summary 


5 text 5 (Search) - Searches for text in current buffer only. 

N text $ (Nonstop Search) - Searches for text through successive buffers by repeatedly 1 
writing out current buffer and reading in next buffer (similar 
to P command, but a form character is not inserted after out- 
putting each buffer) . 

^ $ ' af“:trlt:Tca°mldr CeSSlVe h' ^ 


NOTES 


: causes the search command to have a numeric value at 
completion; 

0 if the search has failed (the requested text was not 
found) or -1 if the search was successful (the requested text 
was found) . 

@ ideates that the text to be matched is delimited by some 
character (same as in the @1 command) . 

A numeric argument can appear following the inodifiers (if 
any) bid- must precede the command. If the numeric argument 
is n, TECO searches for the nth occurrence of the text If 


- v, 







IEB5BBEE31 


Use of special characters within text: 
fS - Match any separator character (any 


character not a letter, number, period, 
dollar sign, or percent symbol). 

fX - Match any (arbitrary) character. Used 

when the contents of some position within 
the text is unimportant. 

INx - Match any character except x . 


tQ - Takes the next character literally , even 
if it is one of four special characters. 

For example, S tQ tX $ - Find the character 

tx. i 


See note under TECO. Basic Commands 


Search Commands Summary 


Command 

Action at End 
of Buffer 

Action at End 
of Rle 

S 

Failure 

N/A 

:S 

Failure 

N/A 

, N 

Performs a P command 
(but a FORM character 
is not inserted) and 
resumes search 

Failure 

:N 

Performs a P command 
(but a FORM character 
is not inserted) and 
resumes search 

Failure 

' 

Performs a Y command 
(read only) and resumes 
search 

Failure 


Performs a Y command 
(read only) and resumes 
search . 

Failure 


Values 

Success Fail 


Typeout ? 
if Failure 










Command 


Function 


Use. Places the numeric value n in Q-register i. , ' 

Q-register. Represents the current value in Q-registei 

Adds I to the value in Q-register i and represents the 
new value. . ' 

Xfer. Copies characters m+1 through the nth charactei 
of the buffer into Q-register i . Does not alter buffer 
contents or pointer. 

• 

Copies the buffer characters between the current Point* 
position and the nth LINE-FEED character in Q-registe 

Get. Inserts the text contained in Q-register i into tht 
buffer beginning at the current pointer location. Set; 
the pointer to the right of the insertion. 

Pushes the contents of Q-register i onto the Q-register' 
pushdown list. • 

Pops the top entry of the Q-register pushdown list into 
Q-register i . The Q-register pushdown list is cleared .. 
each time two successive $s are typed. 


Macro, Iteration, and Conditional Commands 


Macro. Perform the text in Q-register i as a series of 
commands. < 

Iteration brackets. When > is encountered, command^ 
interpretation is sent back to <. / 

Perform the commands within the iteration brackets 
n times. 

If not in an iteration, an error results. If most recent^ 
search foiled, send command interpretation to iust • 


> 


' ' ' 







HgnlgRBSK 


„ - 


Numeric Values and Arguments in Command Strings 


Command 


Function 


Man/ command string formats permit arguments with numeric values. The following characters may 
appear in a command string to develop these values in any instance where a numeric value is permiss- 


Represent their corresponding numeric values. 
Beginning. Equivalent to 0. ^ 

Equivalent to the number of characters in the buffer. 

Equivalent to the number of characters to the left 
of the current pointer position (or in other words, 
equal to the current pointer position). 

Q-register. Equivalent to most recent numeric 
value placed in Q-register i . 

ASCII. Equivalent to ASCII value of character to 
right of pointer; n is used to differentiate this 
argument from an Append command (A) and has no 
other significance. 

Equivalent to value of elapsed time in 60ths of a 
second since midnight . 

Equivalent to the value of the console data switches. 


0 through 9 

B 

Z 


The double quotation mark (") and the single quotation 
mark (') symbols are matched in the same way as the left 
parenthesis symbol, (, and right parenthesis symbol, ). 


If n is Equal to 0, perform commands up to next ' . 
Otherwise, skip to next '. 


If n is a symbol Constituent (a letter, number, period, 
dollar sign, or percent symbol), perform commands 
up to next 1 . Otherwise , skip to next 1 . 

' * 

NOTE ! 


If n is Less than or equal to 0, perform commands up 
to next Otherwise, skip to next 


n"N 


If n is Not equal to 0, perform commands up to next 1 . 
Otherwise, skip to next 1 . 


n"C 










Command 


Function 


Has the value of the form feed switch. If, during the last 
Y or A command execution, data transmission was terminated 
by a form feed character, tE has a value of -1 , otherwise, 
the value is 0. 

(On Teletype Models 33 and 35, hold down both the CTRL 
and SHIFT keys and type N.) Equivalent to the ASCII value 
the command string; this character 


of the next character in 
is not interpreted as a command . 

Typed Character . Stops command execution unti I user types 
a character on the Teletype; tT then becomes equivalent to 
the ASCII value of the character typed. 

Equivalent to the value represented by the digits (or minus • 
sign) immediately following the current pointer position. 

The value is terminated by the first nonnumeric character 
encountered. The pointer is positioned immediately following 
the value.' 

Subtract} Take 
Multiply 

Divide (truncates) 

Logical AND; bitwise AND of binary represc 

Logical IOR; bitwise inclusive OR of binary 
m and n. 

Operators +, -, *,/,?, and $ are normally 
to right. This sequence can be overruled by 


one or two arguments. A space is equal to +. 


Take one or two arguments 


NOTE 


TECO does not assume that multiplication and division are 
always performed before addition and subtraction. Thus, t< 
obtain the equivafent of a + (b * c), one must use the parei 
theses; otherwise, (a +b) *c is assumed. 


Causes the value of n to be typed out . 

Abbreviation for B, Z. (0 through the last location of the 
buffer; in other words, the whole buffer). 


NOTE 


If a command takes two numeric arguments, a comma is used 
to separaf e them . 
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TECO Termination Commands 


Search 


Search for a Special Character 


3 . Perform a search for a LINE-FEED 
character (S LINE-FEED $); if one is 
found , add 1 to Q-register N G%N) . 

Go back (< >) and repeat this cycle until 
the end of the buffer is reached and the 
test fails G); a* this point type out the 
contents of Q-register N(QN =) . 

Whenever JUMPA appears in the current buffer 

replace it with JRST-. . 


JcSJUMPA s; -4DIRST'$ 


Search for any character except A within the 
current buffer. 

Search for any separator character within the 
current buffer. 


Stand-Alone Examples Advanced) 


J3SM0VE $ IM $ 


Within the current buffer, search for the third 
occurrence (3S) of the text MOVE, position the 
pointer immediately after it, and insert an M at 
that point. 


Command 


tG (BELL) 


Function 


J0UN <Si 

$ J%N>QN = 

. f 


Returns control to the Monitor without waiting 
for any I/O operations to finish. 

Returns control to the Monitor after completing 
all current output requests. 

* 


Q-Registers, Macros, Iterations, and Conditionals 


Count the number of LINE-FEED characters in 
the buffer as follows: 


• 1 . Position the pointer at the beginning of 
the buffer (J), 

2. Place 0 in Q-register N(0UN), 








Command 


Function 


1 . Position the pointer at the beginning of 
the buffer (J) . 

2. Search for JUMP A; when found, backspace ' 
the pointer four positions and delete the four ' 
characters passed over (;- 4D) . 

3. Replace these four characters with the J'M f 
characters RST (IRST). 

4. Repeat this routine (< ^ until the test 
fails (end of the buffer has been reached) 
and exit 0) fa >. 


Placing a Command in a Q-Register for Later Execution 


SI# J0UN <Si 


1 . Insert the text 'JOUN <SjJ $; %N >QN=" 

into the buffer (@I* # ) 

2. Copy the contents of the buffer into 
Q-register P (HXP) . 


To Execute the Command; 


ERDTA3 :FN«EX S YMP 


1 . Read in a page of a file to search . 
(ERDTA3:FN.EX $ Y) 

2. Execute the command stored in Q-regist< 


ding in Text to be Inserted in Several Places 
in a File and Storing it in a Q-Register 


1 . Assume that the text to be inserted is on |j 
paper tape. Open an input file on the paper y 
tdpe reader (ERPTR:); read the text into the 
buffer (Y); copy the contents of the -buffer >gjj 
into Q-register P (HXP) . 

2. Open the input file to be edited and the )^ 
output file to contain the edited version. ^ 


ERPTR : S YHXP} 


ERDTA4 : TXTEDT S ) 


EWDSK : TXTEDU 
YNCALC: $ GPi 


3 . Read a page from the input file and initial 
a search for the text CALC: When found 
insert the text stored in Q-register P at that - 
point (GP). 

4. Search for the text TOT: and, when found 
insert the text stored in Q-register P after it^ 


NTOT : S GP 








Examples (Advanced) 


.R TECO ) 

*ERMTA1:$EM14EM$S) 


EZDTAf.REVFILSS}. 


NTA XR T$0LT; 

ixissj 


aaaa. . .TAXRT aaaa. 


*J NTXRTES0LT . QLT) 


bbb . . .TXRTE bbb bbbbb 


* NTXTEND: J ) 

J<SA$;1A-47”G1A-58”L-DIB$“>; 

PWEFSS) 


*tGS$2 
f EXIT i ' 
[tCj 


Select MTAlfor input; rewind the tape 
(EM) and advance the tape one file (14EM). 

Select DTA1 for output; zero the directory; 
open a file and call it REVFIL. 

Read ir| the first page from the input file; 
search for the text TAXRT; if it cannot be. 
found, write the buffer out, read in the j 
next page, search again, etc.; continue j 
this cycle until either TAXRT is found or 
end of file is reached. If TAXRT is found, 
position the pointer at the beginning of the 
line containing it, type the line, and place 
the line in Q-register 1 . 

Search the buffer for the text TXRTE; if not 
found, write out the buffer, read the next 
page, search. again; continue this cycle 
until either TXRTE is found or end of file is 
reached. If TXRTE is found, position the 
pointer at the beginning of the line contain- 
ing it, type the line, and insert the contents 
of Q-register 1 immediately before that line. 

Read pages from the input file and write 
them on the output file until end of file 
(marked by the text TXTEND;) is found. 

At that point, move the pointer to the be- 
ginning of the buffer (J) , and search for all 
As in the buffer (SA); if the character follow- 
ing Hie A is a digit, 0 through 9 (ASCII codes 
48 iq through 57 iq), change the A to a B 
(IB); continue searching and modifying until 
end of buffer is reached; write out the last ' 
page and write end of file on the output 
device. 

Return control to the Monitor after all output 
requests have been completed. 


Command 


Function 







Diagnostic Messages 


TECO Diagnostic 


Meaning 


TECO attempted to read commands beyond the terminating $$. 
This error is probably due to an unterminated @I.or @S comma 
or to an unsatisfied O command. 

Same as 1 . f 

An attempt was made to supply more than two arguments to a 
command, either by the use of two commas or by "H," . 

Too many right parentheses . 

= command with no argument. 

U command with no argument. 

Q,U,X, or G command specifies an illegal Q-register (f.e., 
other than A through 2 or 0 through 9) . 

In an X command > the second argument is not greater thanThe 
first . 

In a G command, the Q-register does not contain text. 

In a G command , the data in the Q-register is not in correct 
form (this is an internal error) . , V. 

In an Ec command (e.g., ER, EW, EF, etc.),.c is illegal. 

File not found on LOOKUP. ^ / 

Blank filename specified for directory device. 
Project-programmer number specified does not have UFD. 


Message 

Meaning 

?n 

n is a decimal number associated with one of the list of error 
messages given in Table 2-5. 

TECO ignores the remainder of the command string and returns 
to the idle state. At this point, the user can type back ?, 
causing TECO to type out the command string terminated by 
the bad command . 











Error List for ?n Messages 


n 10 

Meaning 

15 

Protection failure on disk. 

16 

File cannot be accessed because it is currently being written. 

17 

LOOKUP or ENTER returned erjpr type 6 (not defined). 

18 

LOOKUP or ENTER returned error type 7 (no device). * 

19 

Directory full on ENTER. j 

20 

Requested I/O device not available. 

21 

Not assigned. 

22 

EW command between an EB command and its EF . 

23 

EM command given, but no input file open. 

24 

nEM command, where n is not in the range 1 to 16. 

25 

Internal error: EF after EB, but no input file is open. 

26 

• Illegal character in filename. 

27 

Illegal character in project-programmer number. 

28 - 

Attempt to read ar> input page when no file has been opened 
for input. 

29 

I/O error on input device. 

30 

Attempt to output a page when.no file has been opened for output. 

31 

Two arguments were supplied for an L command. 

32 

Attempt to move pointer beyond page. * 

33 

A 2-argument command has its second argument less than the 

/ 

first argument. 

. 34 

Attempt to search for too long a character string . 

. 35 

Search command did not find the required string. 

36 

In an M command, the Q-register does not contain text. 

37 

In an M command , the data in the Q-register is not in correct 

■‘.38 

form (this is an internal error) . 

Unmatched right angle bracket. 





Error List for ?n Messages 


Meaning 


; encountered when not in iteration. 

" command with no numeric argument, or "x where x is not 
G, L, E, N, orC. 

This is the number typed out at the end of the ? command's dump 
of the command string in error. Refer to the number of the previous 
error . 

A character has been encountered as an undefined command. 

A fD command, when DDT has not been loaded with TECO . 

Not enough core available from the Manitor. 

A RENAME attempted with either a blank name or one already in 
use. Presumably due to a fault in the EB command. 


Debugging Aids - As an aid in debugging macros and iterations, TECO can be set in the trace mode by V’; 
typing ? as any character other than the first in a command string . When in Trace Mode, TECO types 
out each command as it is interpreted, interspersed with requested output. Typing a second ? in the 
same manner takes TECO out of Trace Mode; the ? can be typed each time it is desired to change the 
current mode . 


The user can also type comments on his teletype sheet as he executes TECO by typing: 


t Atext tA 


This causes all text entered to be printed on the teletype (with the exception of terminating tA 
character) . 


NOTE 


Since the terminator tA is not a command, it must be 
typed by holding the CTRL key down while typing A. 
It cannot be entered as "up. arrow. A." 


If DDT has been loaded along with TECO by the Linking Loader, control can be transferred to DDT by 
using the command fD. 








To call in TECO and open a new file for creation: 


MAKE filename. ext ^RTECO 

* (text input commands) $$ *EWDSK:filename .ext $$ 

*EX $$ i(text input commands) $$ 

!EX $$ ^ 

To call in TECO and open an already existing file for creation: 


Monitor Commands 


Monitor Commands 


Equivalent CUSP Commands 


Monitor Commands 


Equivalent CUSP Commands 


^TECO filename .ext 
♦(editing) $$ 

SEX$$ 


. R TECO 

*EBDSK:filename.ext $ Y $$ 
1 (editing) $ $ 

*EX $$ 
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Initialization 


PERIPHERAL INTERCHANGE PROGRAM (PIP) 

PIP transfers data files from any standard I/O device to any other standard I/O device and, additionally, 
performs simple editing and magnetic tape control functions. PIP1 , a compact version of PIP, performs 
a subset of PIP functions. PIP handles all data formats, and eliminates the need for a satellite computer 
to handle off-line data conversions. 


Requirements 


PIP' Minimum Core: 3K 


Equipment Handled: 


Additional Core: IK if disk is one of the I/O devices; 

any core above that required is used 
for extra I/O buffers . 

DECtape, disk, magnetic tape, paper tape reader, 
paper tape punch, card reader, line printer, and 
teletype. 


PIP I Minimum Core: IK 


Equipment Handled: 


Additional Core: Any core greater than IK is used 
for extra input buffers. 

DECtape, disk/ magnetic tape, paper tape reader, 
paper tape punch, card reader, line printer, and 
teletype . 


Loads PIP (or PIP!) into core. 

PIP is ready to receive a command; an asterisk 
is typed after each requested action has been 
completed. 

' • ■ 

• -it:--, ■ 



Commands 


destination-dev:filename.ext -source-devrfilename.ext 


destination-dev: 

source-dev: 


The destination device, to which the data is to be 
transferred; the source device(s), from which the 
data is to be read 


NOTE 


If logical device SYS (the CUSP device) is a 
DECtape, it must not be modified using the 
/R or /D switches or any other request re- 
quiring it to be initialized for input and out- 
put at the same time . 


DTAn: 

PTR: 

PTP: 

DSK: 

CDR: 

MTAn: 

LPT: 

TTY: or 
TTYn: 


(DECtape) 

(paper tape reader) 
(paper tape punch) 
(disk) 

(card reader) 
(magnetic tape) 
(line printer) 
(Teletype) 


If more than one file is to be transferred from a magnetic 
tape, card reader, teletype, or paper tape reader, dev: 
is followed by a comma for each file after the first; 
these devices can also be followed by * or *.* to in- 
dicate all files are to be transferred. 


filename. ext (DSK: and DTAn: only) 


The filename and filename extension to be assigned 
to the file on the destination device; the filename 
and filename extension of the file(s) to be read from 
the source device. 

An asterisk can be used for source files 

filename.* - Transfer all files having the 
specified filename. 

*.ext - Transfer all files having the 

specified extension. 

*.* - Transfer all files. 

- Transfer all files with null 
extensions . 


follows 


General Command Format 
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Command 


Function 


Loads and starts PIP . 

Transfer the file named FILET from DTA1 
to the line printer 

Transfer all files with null extensions from 
DTA1 to the line printer . ’ 

Transfer the file named FILE 1 'JMP to DTA2 
and give it the, name FILE2. 


*LPT 


♦LPT 


+DTA2 :F ILE2-DTA1 :FILE1 -TMP) 


Disk File Descriptor Format 


DSK:filename .ext [proj / prog] <protection > 

[ proj ,prog ] Project-programmer number assigned to the disk 

area to be used, i Pother than the user's project- 
programmer number.. • v * 

*<protection > Protection value to be assigned to the destination 

file. If omitted, the standard protection is assigned. 


Standard Assumptions 


Unless otherwise changed by switches, all files which are on directory devices and which have a file- 
name extension of .REL, .SAV, .DMP, or .CHN are copied in binary; all other files are assumed to be 
in ASCII line mode. Magnetic tape files, unless otherwise changed by switches, are read in odd parity 
and written in odd parity at 556 bpi . 


The destination descriptors and the source 
descriptors are separated by the left arrow 
symbol (~) . 


NOTE 


Standard protection (055) designates that the 
owner is permitted to read or write, or change 
the protection of, the file while others are 
permitted only to read the file. 



■» il V. 


Command 


Function 


Switches 


*DTA2 :FILE3-DTAl : F ILE1 *FILE2 ) Transfer the files named FILE 1 and FILE2 

from DTA1 to DTA2, combining them as one 
file under the name FILE3. 

*DTA2 :FILE3-DTAI :FILE1 »DTA3:FILE2 ) Transfer the file named FILE1 from DTAI and 
• ‘ the file named FILE2 from DTA3 to DTA2, 

combining them as one file under the name 
FILE3. •,& 


*DSK:FILE1-MTA1 : } 


*DSK:F I LEI <177>-MTA1 :* ) 


Transfer the next file from the present 
position of MTA1 to the user's area on the 
disk, call -it FILE 1 # and assign the standard 
protection of 055 . , --Jj-. 

Transfer all files from MTA1 (starting at 
the current position of the read head) to the 
user's area on the disk, combining them into 
one file called FILE1 , and assign protection 
177. 

Transfer the next two files from the present 
position of MTA1 to area 1 ,3 on the disk, 
combining them into one file called FILE! , 
and assign the standard protection (055). 

Transfer five files from the paper tape reader, 
combining them as one file on the paper tape 
punch. Js| 

Return to Monitor.. 

Dot indicates that user is at Monitor level . 


Nonmagnetic-tape switches, when used, are preceded by a slash (if more than one is specified, they 

• 5 ••> # # # 'X# 

may be enclosed by parentheses instead) and can appear anywhere in the command string; however, if ■; $j 

the command string contains commas, the switches must be specified prior to the first comma. 

Magnetic tape switches are enclosed by paren^^®ses and must appear immediately following the device 
or file to which they refer. Sa 

_ Switches are used to specify: 

a. Particular files for transferral or deletion; 

| b. Editing; . - - r'i 

c. Mode of transfer; 


‘ . ; t ■. • 

d. Directory manipulation (DECtape and DSK); and 
.... e. Magnetic tapexontrol . • 







NOTE 

MTA switches always apply to the device or file immedi- . 
ately preceding the switches . MTA swishes should “be . 
used only in specific situations. For a more detailed treat 1 - . 
ment, see PIP Programmer's. Reference Manual. 


Switch 


Meaning 


Line blocking i ^ 

Process file in Binary mode. j 

Suppress trailing spaces and Convert multiple spaces to tabs. 

Delete the file. 

Treat Ending (card) columns 73 through 80 as spaces. 

List the directory in short form for DSK: or DTAn: only. (Filenames 

and extensions only.) Useful when disk directory cannot be listed with /L sw. 

Ignore I/O errors. 

Process file in image binary mode. 

Process file in Image mode. 

List the directory (DSK: or DTAn: only) 

Magnetic tape switches. A string of one or more magnetic tape 
switches begins with an M and is enclosed in parentheses. 

*nA Advance the tape n files. E Even parity. 

*nB Backspace the tape n files. • F Mark End of File. 

*nD Advance the tape n records. T Skip to logical end of Tape. 

*nP Backspace the tape n records. ^ 

2 200 bpi density . 

5 556 bpi density . 

8 800 bpi density. . _ U . Rewind tape and Unload. 

A Advance tape one file. W Rewind-the tape. 

B Backspace tape one file. 


A listing of PIP switches can be obtained by typing 
ioutput-dev:/Q - *' ) 

where output-dev: may be either LPT: or TTY: 


PIP Switch Options 











Switch 


Meaning 


Source extension: 


Destination format: 


RIM Loader, RIM10B Rle 
XFERWD • 

RIM10B File only. 

RIM10 


Zero out the directory (DTAn: or DSK: only) 


NOTE 


Switches A, B; N, S, and Z are available for use in PIPl 
Y is- an optional switch obtained by setting RIMSW= 1 at 
assembly time (see PIP, OPR file for explanation of PIP 
assembly and loading procedures). 


PIP Switch Options 


Delete the sequence Numbers from a file. 

Same as /S switch except sequence numbers are incremented by 1 (One). 

FORTRAN output file format assumed as input . Convert format control 
characters for line Printer listing. 

Print this list of switches. 

Rename the file. 

Add Sequence numbers to the file or resequence a file already containing 
Sequence numbers; Sequence numbers are incremented by 10. 

Suppress Trailing spaces. 

Copy blocks 0 - . 1 and 2 of a DTA file. Commonly used to transfer TENDMP. 
Count unmatched angle brackets < >. 

Copy specified files only. 

Perform a RIM DTA to PTP conversion . 




*DSK: (DX)-DTAl :FILEI **.REL } 


*MTA2 : /S-CDR : ) 


VLPT:/P-DTA1 ,FILE1 ) 


*DTA2 :F ILE1 /I-PTR : X 


*TTY:/L-DTAl : } 

rnnnn FREE BLOCKS LEFT ) 
l_filename.extno. blocks creation date 


*DTA1 :/Z- ) ' 

*MTA2 : (M8E)-MTA1 : CME8) i 
*MTA2 : (MW )•* } 

*LPT:-MTAl : ( M2 W );( MA » ) 


*MTA1 :(M#4A)-CDR: J 


Load and run PIP. 

Transfer all files from DTA1 to DSK, 
keeping them separate and retaining 
their filenames. 

Transfer all files, except FILE! and 
any files with the extension . .REL, 
from DTAl.to DSK, keeping them 
separate and retaining their filenames. 

Transfer a file from the card reader to 
MTA2 and add sequence numbers. ^ 

Take-FILEl (a FORTRAN output print j 
file), interpret the carriage control f / 
characters, and print the file using specified 
carriage control . 

rni > ' 

Initialize both DTA2 and the paper tape 
reader in image mode and. transfer one. 
file from the paper tape reader to DTA2, 
caljing it FILEl , 


List, the directory of DTA1 on the 
teletype. 


Zero the directory of DTA1 . 

Transfer a file from MTA1 to MTA2 in 
800 bpi , even parity mode . 

Rewind MTA2 . 

Set.MTAl to 200.bpi, odd parity, 
rewind the tape, and transfer the first, 
third, fourth, end fifth files to the 
printer. L 

Advance MTA1 four files before trans- 
ferring a file from the card reader. j 

Return to the Monitor. 


Examples 



Meani 


?4K NEEDED 


4K is not currently available but is needed 
when a disk is present in the system . 

I/O device for copy block 0 (/U) must be 
a DECtape. 

Either device name has been misspelled 
or there is no such device . 

The device has been assigned to another 


7DECTAPE I/O ONLY 


7DEVICE dev: DOES NOT EXIST 


7DEVICE dev: NOT AVAILABLE 


7DIRECTORY FULL 


DISK DIRECTORY READ 


ceded by a 7. A second message follows - 
(see Table 6-3) . 

This command requires a directory device 
for input . 

DTA input and PTP output must be speci- 
fied for /Y. 

Each file requested does exist , but one or 
more was unavailable for processing. This 
message is never fatal . 

Extension for /Y request must be .RMT, 

• RTB, or .SAV. 

1 . Zero-length file; or 

2. Requisite fob data info not available; or 

3. Block overlaps previous block (RIM 10)oi 

4. EOF found when data was expected, or 

5. A pointer word was expected but not 
found in the source file. 

Disk file named is currently being processed 
by another job . 

Filename. ext not found during LOOKUP. 


7DISK QR DECTAPE INPUT REQUIRED 


?filename.ext (3) FILE WAS BEING 
MODIFIED 

?filename.ext (0) FILE WAS - NOT 


FOUND 


Diagnostic Messages 


PIP Diagnostic Messages 


lb*; 


?DTA TO PTP ONLY 


FAILURE DURING (A,/£,/D ,/R) S 
REQUEST 


7FILE filename .ext ILLEGAL RIM 

EXTENSION 

7FILE filename .ext ILLEGAL FORMAT RIM 
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PIP Diagnostic Messages 


Meani 


?filename.exf (0) ILLEGAL FILE NAME 


I Indicates that 

1 . No fl lename was specified for DTA 
output file; or 

2 . A reject occurred on a 
for disk file; or 

3 . Illegal filename was specified for a 

/R request on DTA. 

The project-programmer number specified 
for a DSK file is incorrect. 

This message is nanfatal if the /G switch 
is used; otherwise, it is fatal and is pre- 
ceded by a ?. A second message follows 
(see Table 6-3) . 

A line >140 characters was detected in 
the source file. 

Load point on a 


request 


?filename 


ext (I) NO SUCH PROJECT- 
PROGRAMMER NUMBER 

INPUT DEVICE dev: 


FILE filename 


?LINE TOO LONG 


?LOAD POINT BEFORE END 
(MB) OR (MP) REQUEST 


- magnetic tape file has 
been reached before the tape has been 
backspaced the number of files or records 
specified in (M*nB), (M*nP). 

/U given but PIP assembled without 
provision for this.*' ' 

No such file found during PIP directory 
search. < '■ 

The data file for the /Q switch is not 
available.. * x ‘ ; • 

Followed by a second message (see Table 


2 NO BLOCK 0 COPY 


?NO FILE NAMED filename 


?NO FILE NAMED QPIP 


OUTPUT DEVICE dev: 


FILE filename 


?PIP COMMAND ERROR 


1 . Illegal format for command stri 

2 . Nonexistent switch requested; 

3 . Fi rename .ext other than 

* (or *. *) requested for a non- 
directory device; or 

4. The illegal switch combination 

Same as FAILURE DURING . . . mes 
except that the processing halts. 

- . , '* •Ur 

Iried to rename file with already 

existing name. ' : v‘' '-5 • , 


?fi lename 


ext (2) PROTECTION FAILURE 


?fi lename . ext (4) RENAME 
FILENAME ALREADY EXISTS 
?fi lename ,«t (5) RENAME ERROR 
?fi lename. ext (6) 

?fi lename. ext (7) 


LOOKUP or ENTER not done, 


Error not yet defined, 
Error not yet defined; 




PIP Diagnostic Messag< 


•7TERMINATE A MAX of 999 FILES 
PROCESSED 


The A switch specified for nondirectory 
device source files has processed the 
maximum number of files (999) . 

Conflicting parity/density requests have 
been given for a magnetic tape. 

During a PIP1 run, a switch or function 
which is not present in PIP! has been - 
requested . 


?TOO MANY REQUESTS FOR dev: 


NOTES 


All fatal diagnostic messages are preceded by a question 


Message types are: 


Command string error 
File reference error 
I/O error 

Readin Mode specification error 
Other types of errors . 


Table 6-3 

Secondary PIP I/O Diagnostic Messages 


Meaning 


BINARY DATA INCOMPLETE 


Length of block disagrees with word ' ,i ; ;. 
count (nonfatal If the /G switch has {fit 
been specified) . — - . 

DTA link number >1 101 g . 

Read or write error (nonfatal if the /G 
switch has been specified). 

Block too large for buffer (nonfatal if the 
/G switch has been specified). 

The datacontroT unit has detected the \ 
loss of data (nonfatal if the /G switch has.Jv 
been specified) . 


BLOCK TOO LARGE 
CHECKSUM OR PARITY ERROR 


INPUT BUFFER OVERFLOW 


DEVICE ERROR 
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Equivalent CUSP Commands 


Secondary PIP I/O Diagnostic Messages 


IK Version of PIP (PIP I) Limitations 
The following limitations apply to PIPI:” 

a. Z and MW requests ignore all source devices. 

b. B switch included since REL,SAV,DMP, and CHN files are not automatically copied in 
36-bitbytes. 

c. Error messages assume all I/O devices are DECtape. 

d. Neither project-programmer numbers nor protection can be specified for disk files. 

e. The * cannot be used for filenames or extensions. 

f. SAV files cannot be successfully copied with PIPI . 


/TYPE dev: filename. ext ; .RPIPJ 

*TTY: -dev:filename.ext; 
^ LIST dev:filename. ext; .R PIP ^ 

*LPT: -dev: filename .ext ^ 
^DIRECT dev:) , ^R PIP} 

TTY: -dev:AJ 

^ DIRECT dev:/L i ^ R PIP; 

*LPT: -dev:/L; 


To type the directory 
of a device on the TTY. 

To list the directory of 
a device on the line printer. 


Monitor Commands 

The following Monitor commands perform PIP-type operations. 

Desired Result ( Monitor Command 


To type the contents 
of a file on the TTY. 


To list the contents of 
a file on the line printer. 


PHYSICAL EOT' 


The end of tape has been reached (nonfatal 
if the /G switch has been specified) . 


WRITE (LOCK) ERROR 


DTA,DSK,MTA 


Attempt has been made to write on a write- 
locked file. 


7-9 PUNCH MISSING 


Binary card lacks 7-9 punch (nonfatal if the 
/G switch has been specified). 









Desired Result 


Monitor Command 


Equivalent CUSP Commands 


To delete a file 


DELETE dev: filename .'ext 


.R PIP} 

Mevtfilename .ext/D 
.R PIP} 

*dev:newfn/R -oldfn 


RENAME devtnewfn =*oldfn 


NOTE 


If dev: is omitted in the Monitor commands, DSK: is assumed. 










FILE UPDArE GENERATOR (FUDGE2) 

FUDGE2 updates files containing one ar mare relocatable binary programs, and permits the user to 
manipulate individual programs within program files. 


Requirements 

Minimum Core: 
Additional Core: 
Equipment: 


Dynamically allocates its buffers to utilize as much core as is made available. 

Two input devices, one for the master file and one for the transaction file- 
one output device for the updated file. The input device(s) and output ’ 
device can be the same device (DSK:). The two input devices con be the ! 
same DECtape. 


Initialization 


• R FUDGE2 2 


Loads the File Update Generator program. 
FUDGE2 is ready to receive a command . 
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MONITOR COMMANDS 


NAME 


ARGUMENTS 

VIATION 

- T- T 

» 1 


* 

J 


warn 



if 











EH 



In' 



ATTACH 

AT 

job 

proj prog 




CCONT 

CC 






COMPILE 

COM 

list 





CONT 

CON 

Ih 

rh 

adr 



CORE 

COR 






CREATE 

CREA 






CREF 

CREF 

dev 





CSTART 

CS 

list 





CTEST 


list 





D( deposit) 

D 

dev 





DAYTIME 

DA 

dev 





DDT 

DD 

adr 





DEASSIGN 

DEA 

file 

ext 




DEBUG 

DEB 

list 





DELETE 

DEL 

dev 





DETACH 

DET 

dev 

file 

ext 

proj prog 

core 

DIRECT 

DI 






E(cxamine) 

E 






EDIT 

ED 

list 





EXECUTE 

EX 

list 





FINISH 

F 






GET 

G 

file 

ext 




HALT 

+ c 






KJOB 

K 

file 

ext 

core 



LIST 

LI 

dev 

job 




LOAD 

LOA 






LOGIN 

LOG 

arg 





MAKE 

M 






PJOB 

P 

dev 

file 

ext 

proj prog 

core 

R 

R 

dev 

file 

ext 

core 


REASSIGN 

REA 

n 





REENTER 

REE 

dev 

file 

ext 

core 


RENAME 

REN 

adr 





RESOURCES 

RES 






RUN 

RU 

core 





SAVE 

SA 

file 

ext 




SCHEDULE 

SCH 






SSAVE 

SS 






START 

ST 






SYSTAT 

SYS 






TALK 

TA 

dev 





TECO 

TE 

file 

ext 




TIME 

TI 

job 





TYPE 

TY 

list 


| 
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Make contact with your computer facility by what- 
ever means the facility has established (e.g., acous- 
tic coupler, telephone, or data phone). 

Turn the little plastic knob on the right-hand side 
of the Teletype to ON. 


Type jC on the Teletype (i 


. , r - hold down the 

CTRL key while striking C) . This establishes com- 
munication with the Time-Sharing Monitor. The 
Monitor signifies its readiness to accept commands 
by responding with a period (.). 


Type LOGIN, or LOG, followed by 


, i jpc L.WUN, or luu, followed by a carriage re- 
turn. The system wUl respond with an informative 
message like the following: 

JOB n NAME OF SYSTEM 

# 

JOB n is the job number the system has just as- . 
signed to you. NAME OF SYSTEM is usually the 
_Monitor name and version number. 


Type your project-programmer numbers after the 
number sign, followed by a carriage return. 


The time-sharing 


system will then type 
PASSWORD: 


Type your secret password followed by a carriage 
return. The system will keep the password secret 


by not printing it on the 


If the project-programmer numbers and the pass- 
word match the project-programmer numbers and 
password stored in the system accounting file, the 
system responds with the time, date, TTY number, 
^ C, and a period. 

Example: 

1301 8-Aug-69 TTY23 


I Now the time-sharing system is ready to accept any 
[ commands you wish to type in. You may direct it 
to load and start a program from the System Li- 
brary (,R prog), start a program already loaded in 
core (.START), or perform any of a variety of 
other operations. (See inside of back cover for a 
summary of Time-Sharing Monitor commands. 1 



